|
| 1 | +# Core Concepts |
| 2 | + |
| 3 | +Understanding these fundamental concepts will help you make the most of Codebolt AI Editor. Each concept builds upon the others to create a powerful, integrated development experience. |
| 4 | + |
| 5 | +## Agents |
| 6 | + |
| 7 | +**Agents** are AI-powered assistants that can understand your code and perform tasks autonomously. Think of them as specialized team members that work alongside you. |
| 8 | + |
| 9 | +Agents can analyze code, suggest improvements, generate documentation, run tests, and much more. They're triggered by events (like saving a file) or can be invoked manually. Each agent has a specific purpose and can be customized to match your workflow and coding standards. |
| 10 | + |
| 11 | +**Key Features:** |
| 12 | +- Event-driven automation |
| 13 | +- Context-aware analysis |
| 14 | +- Customizable behavior |
| 15 | +- Integration with your development tools |
| 16 | + |
| 17 | +[Learn more about Agents →](../core/agents/overview.md) |
| 18 | + |
| 19 | +## Multi-Agents |
| 20 | + |
| 21 | +**Multi-Agents** systems coordinate multiple agents to tackle complex tasks that require different specializations. Like a well-organized development team, each agent contributes their expertise to achieve a common goal. |
| 22 | + |
| 23 | +For example, you might have one agent analyze code quality, another handle testing, and a third generate documentation - all working together in a coordinated workflow to prepare your code for production. |
| 24 | + |
| 25 | +**Key Features:** |
| 26 | +- Agent coordination and communication |
| 27 | +- Complex workflow orchestration |
| 28 | +- Parallel and sequential task execution |
| 29 | +- Shared context and data flow |
| 30 | + |
| 31 | +[Learn more about Multi-Agents →](../core/multi-agents/overview.md) |
| 32 | + |
| 33 | +## MCP Tools |
| 34 | + |
| 35 | +**MCP (Modular Component Plugin) Tools** extend Codebolt's capabilities by adding new functionality through a standardized plugin system. These tools can integrate with external services, add new AI models, or provide specialized development utilities. |
| 36 | + |
| 37 | +MCP Tools make Codebolt infinitely extensible, allowing you to integrate with your favorite tools and services seamlessly. Whether you need database connectivity, API testing, or custom visualization, there's likely an MCP Tool for that. |
| 38 | + |
| 39 | +**Key Features:** |
| 40 | +- Standardized plugin architecture |
| 41 | +- Easy integration with external services |
| 42 | +- Custom AI model support |
| 43 | +- Community-driven ecosystem |
| 44 | + |
| 45 | +[Learn more about MCP Tools →](../core/mcp-tools/overview.md) |
| 46 | + |
| 47 | +## Inline Edit |
| 48 | + |
| 49 | +**Inline Edit** is Codebolt's signature feature, accessible via Ctrl+K (Cmd+K on macOS), that allows you to make AI-powered code modifications directly in your editor. Simply select code, press the shortcut, describe what you want, and watch your code transform. |
| 50 | + |
| 51 | +This feature bridges the gap between thinking about a change and implementing it, making code modification as natural as describing what you want in plain English. |
| 52 | + |
| 53 | +**Key Features:** |
| 54 | +- Instant code transformation |
| 55 | +- Natural language prompts |
| 56 | +- Context-aware suggestions |
| 57 | +- Undo/redo support |
| 58 | + |
| 59 | +[Learn more about Inline Edit →](../core/inline-edit/overview.md) |
| 60 | + |
| 61 | +## Chats |
| 62 | + |
| 63 | +**Chats** provide an AI-assisted conversational interface where you can ask questions, get coding help, and discuss implementation strategies. It's like having a knowledgeable senior developer available 24/7. |
| 64 | + |
| 65 | +The chat interface understands your project context, can reference your code, and provides detailed explanations with code examples. It's perfect for learning new concepts, debugging issues, or exploring different approaches to a problem. |
| 66 | + |
| 67 | +**Key Features:** |
| 68 | +- Context-aware conversations |
| 69 | +- Code-specific assistance |
| 70 | +- Learning and exploration |
| 71 | +- Integration with project files |
| 72 | + |
| 73 | +[Learn more about Chats →](../core/chats/overview.md) |
| 74 | + |
| 75 | +## Task Flow |
| 76 | + |
| 77 | +**Task Flow** is Codebolt's workflow automation system that helps you create, manage, and execute complex development processes. Think of it as your personal DevOps pipeline that can be customized for any workflow. |
| 78 | + |
| 79 | +Task Flow can automate everything from code generation and testing to deployment and monitoring. You can create flows that respond to events, run on schedules, or execute on-demand. |
| 80 | + |
| 81 | +**Key Features:** |
| 82 | +- Visual workflow builder |
| 83 | +- Event-driven automation |
| 84 | +- Integration with agents and tools |
| 85 | +- Conditional logic and branching |
| 86 | + |
| 87 | +[Learn more about Task Flow →](../core/task-flow/overview.md) |
| 88 | + |
| 89 | +## Context |
| 90 | + |
| 91 | +**Context** is how Codebolt understands your project structure, dependencies, coding patterns, and development preferences. The more context Codebolt has, the smarter and more helpful its suggestions become. |
| 92 | + |
| 93 | +Context includes your file structure, import relationships, coding style, project configuration, and even your team's conventions. This deep understanding enables Codebolt to provide relevant, accurate assistance that feels tailored to your specific project. |
| 94 | + |
| 95 | +**Key Features:** |
| 96 | +- Project structure analysis |
| 97 | +- Dependency mapping |
| 98 | +- Code pattern recognition |
| 99 | +- Team convention learning |
| 100 | + |
| 101 | +[Learn more about Context →](../core/context/overview.md) |
| 102 | + |
| 103 | +## CLI |
| 104 | + |
| 105 | +**CLI (Command Line Interface)** provides powerful command-line tools for automation, scripting, and integration with your existing development workflows. The CLI is perfect for CI/CD pipelines, batch operations, and advanced automation scenarios. |
| 106 | + |
| 107 | +Whether you're generating code, running agents, managing workflows, or analyzing projects, the CLI provides programmatic access to all of Codebolt's features. |
| 108 | + |
| 109 | +**Key Features:** |
| 110 | +- Comprehensive command set |
| 111 | +- Scriptable automation |
| 112 | +- CI/CD integration |
| 113 | +- Batch operations |
| 114 | + |
| 115 | +[Learn more about CLI →](../core/cli/overview.md) |
| 116 | + |
| 117 | +## TypeScript SDK |
| 118 | + |
| 119 | +**TypeScript SDK** enables developers to build custom extensions, integrations, and tools that extend Codebolt's functionality. With full TypeScript support, you get excellent developer experience with type safety and IntelliSense. |
| 120 | + |
| 121 | +The SDK provides APIs for creating custom agents, MCP tools, workflow steps, and integrations with external services. It's the foundation for building powerful, type-safe extensions. |
| 122 | + |
| 123 | +**Key Features:** |
| 124 | +- Full TypeScript support |
| 125 | +- Comprehensive API coverage |
| 126 | +- Type-safe development |
| 127 | +- Rich documentation and examples |
| 128 | + |
| 129 | +[Learn more about TypeScript SDK →](../core/typescript-sdk/overview.md) |
| 130 | + |
| 131 | +## How These Concepts Work Together |
| 132 | + |
| 133 | +These concepts are designed to work seamlessly together: |
| 134 | + |
| 135 | +1. **Agents** use **Context** to understand your project and make intelligent decisions |
| 136 | +2. **Multi-Agents** coordinate multiple **Agents** through **Task Flow** workflows |
| 137 | +3. **Inline Edit** leverages **Context** and can trigger **Agents** for complex transformations |
| 138 | +4. **Chats** can invoke **Agents** and reference **Context** to provide better assistance |
| 139 | +5. **MCP Tools** extend the capabilities of **Agents** and **Task Flow** |
| 140 | +6. **CLI** provides programmatic access to all features for automation |
| 141 | +7. **TypeScript SDK** enables custom development of all these components |
| 142 | + |
| 143 | +## Getting Started with Each Concept |
| 144 | + |
| 145 | +### For Beginners |
| 146 | +Start with **Inline Edit** and **Chats** to get immediate value, then explore **Agents** for automation. |
| 147 | + |
| 148 | +### For Intermediate Users |
| 149 | +Dive into **Task Flow** and **Multi-Agents** to create sophisticated workflows. |
| 150 | + |
| 151 | +### For Advanced Users |
| 152 | +Explore **MCP Tools**, **CLI**, and **TypeScript SDK** to build custom solutions. |
| 153 | + |
| 154 | +## Next Steps |
| 155 | + |
| 156 | +Now that you understand the core concepts, you're ready to: |
| 157 | + |
| 158 | +1. **Explore specific features** by following the links to detailed guides |
| 159 | +2. **Try the hands-on tutorials** in [tutorials.md](../tutorials.md) |
| 160 | +3. **Build your first custom solution** using the [TypeScript SDK](../core/typescript-sdk/overview.md) |
| 161 | + |
| 162 | +Each concept has its own dedicated section in the [Core](../core/) documentation where you'll find detailed guides, examples, and best practices. Choose the concept that interests you most and dive in! |
0 commit comments