11# Codebot
22
3+ [ English] ( README.md ) | [ 中文] ( README_zh.md )
4+
35Terminal-native AI coding agent. Built on [ agentcore] ( https://github.com/voocel/agentcore ) , a minimal agent execution kernel.
46
57```
@@ -23,9 +25,12 @@ Each layer has one job. No layer knows about the layers above it.
2325
2426** Agent**
2527- Streaming responses with extended thinking (off → xhigh)
26- - Tool execution: read, write, edit, bash, grep, find, ls
28+ - Tool execution: read, write, edit, bash, grep, find, ls, web_search, web_fetch
29+ - Task management: task_create, task_get, task_update, task_list (SubAgent coordination)
30+ - SubAgent delegation with parallel/chain execution
2731- Automatic context compaction when window fills up
2832- Multi-provider: Anthropic, OpenAI, Gemini
33+ - MCP (Model Context Protocol) server integration
2934
3035** Sessions**
3136- Append-only JSONL persistence — crash-safe, human-readable
@@ -40,6 +45,10 @@ Each layer has one job. No layer knows about the layers above it.
4045
4146** Interface**
4247- Interactive TUI with real-time streaming and markdown rendering
48+ - Plan mode: agent proposes changes, user reviews and approves
49+ - AskUser: structured multi-choice questions from agent to user
50+ - Image paste (Ctrl+V) with selection (↑) and deletion (Delete)
51+ - Task progress display: progress bar + status icons above input
4352- Non-interactive print mode for pipes and scripts (` -p ` )
4453- Slash commands: ` /model ` , ` /compact ` , ` /plan ` , ` /resume ` , ` /copy ` , ...
4554
@@ -77,11 +86,17 @@ codebot -policy-profile strict
77863 . ** Convention over configuration** — sensible defaults, explicit overrides
78874 . ** Secure by default** — balanced policy, audit trail, workspace boundaries
7988
89+ ## Configuration
90+
91+ Config files: ` ~/.codebot/settings.json ` (global) or ` .codebot/settings.json ` (project-level, takes precedence).
92+
93+ All fields are optional. See [ settings.example.jsonc] ( settings.example.jsonc ) for the full reference with comments.
94+
8095## Requirements
8196
8297- Go 1.25+
83- - API key for at least one provider ( ` ANTHROPIC_API_KEY ` / ` OPENAI_API_KEY ` / ` GEMINI_API_KEY ` )
98+ - API key for at least one provider
8499
85100## License
86101
87- MIT
102+ MIT
0 commit comments