A Rust TUI coding agent. Connects to any OpenAI-compatible API (Ollama, OpenAI, etc.) and provides an interactive terminal interface for code generation, analysis, and assistance.

• Tool use — file read/write/edit, glob, grep, bash execution, web fetch and search
• Permission system — granular allow/ask/deny rules per tool, bash pattern, and URL domain
• 4 modes — Normal, Plan, Apply, Yolo with different permission defaults
• Vim mode — full vi keybindings for the input editor
• Session management — auto-save, resume, and fork conversations
• Auto-compact — LLM-powered conversation summarization to reduce token usage
• Reasoning effort — configurable thinking depth (off/low/medium/high)
• File references — attach file contents with @path syntax
• Background processes — async bash execution with completion tracking
• Custom instructions — project-level AGENTS.md files
• Image support — paste images from clipboard or reference them in messages
• Shell escape — run shell commands directly with !<command>

cargo install --git https://github.com/leonardcser/agent.git
# or locally
cargo install --path .

Config file: ~/.config/agent/config.yaml (respects $XDG_CONFIG_HOME)

# Providers: named connections to OpenAI-compatible APIs
providers: - name: ollama type: openai-compatible # only supported type api_base: http://localhost:11434/v1 models: - glm-5 # simple string form - name: llama3.3:70b # object form with sampling overrides temperature: 0.8 top_p: 0.95 top_k: 40 min_p: 0.01 repeat_penalty: 1.0 - name: anthropic type: openai-compatible api_base: https://api.anthropic.com/v1 api_key_env: ANTHROPIC_API_KEY # env var containing the API key models: - claude-sonnet-4-20250514 # Startup defaults
# These only apply on fresh startup when no explicit model is selected.
# If defaults.model is set, it takes priority and overrides any cached selection.
# If defaults.model is NOT set, the last used model from the previous session is used.
defaults: model: ollama/glm-5 # provider_name/model_name reasoning_effort: "off" # "off" | "low" | "medium" | "high" # Runtime settings (all toggleable via /settings)
settings: vim_mode: false # vi keybindings (default: false) auto_compact: false # auto-summarize long conversations (default: false) show_speed: true # show tokens/sec (default: true) restrict_to_workspace: true # downgrade Allow→Ask for out-of-workspace paths (default: true) # Visual appearance
theme: accent: "lavender" # preset: lavender|sky|mint|rose|peach|lilac|gold|ember|ice|sage|coral|silver # or ANSI value: 0-255 # Permissions: control what the agent can do without asking
# Each mode (normal, apply, yolo) has three categories: tools, bash, web_fetch
# Each category has three rule lists: allow, ask, deny
# Rules use glob patterns — deny always wins
# Unmatched tools/patterns default to Ask in normal/apply, Allow in yolo
permissions: normal: tools: allow: [read_file, glob, grep] ask: [edit_file, write_file] deny: [] bash: allow: ["ls *", "grep *", "find *", "cat *", "tail *", "head *"] ask: [] deny: [] web_fetch: allow: ["https://docs.rs/*", "https://github.com/*"] deny: ["https://evil.com/*"] apply: tools: allow: [read_file, glob, grep, edit_file, write_file] bash: allow: ["ls *", "grep *", "find *", "cat *", "tail *", "head *"] yolo: tools: deny: [] bash: deny: ["rm -rf /*"]

Default permissions (when permissions is omitted):

--model <MODEL>         Model to use (overrides config)
--api-base <URL>        API base URL (overrides config)
--api-key-env <VAR>     Env var for API key (overrides config)
--log-level <LEVEL>     trace | debug | info | warn | error (default: info)
--bench                 Print performance timing on exit

CLI flags take precedence over config file values.

Press Shift+Tab to cycle through modes:

• Normal — default; agent asks before editing files or running commands
• Plan — read-only tools only; agent thinks and plans without making changes
• Apply — agent edits files and runs pre-approved commands without asking
• Yolo — all permissions default to Allow; configurable via permissions.yolo in config

Type / to open the command picker:

Prefix with ! to run a shell command directly (e.g. !git status).

Type @ followed by a path to attach file contents to your message. A fuzzy file picker opens automatically.

Place an AGENTS.md file in your project root or in ~/.config/agent/ for global instructions. The agent includes these in its system prompt automatically.

Sessions are saved automatically to ~/.local/state/agent/sessions/ (respects $XDG_STATE_HOME) and restored on SIGINT/SIGTERM. Use /resume to load a previous session and /fork to branch from the current one.

cargo build # compile
cargo run # run
cargo test # run tests
cargo fmt # format
cargo clippy # lint

This project was inspired by Claude Code.

Contributions are welcome! Please open an issue or a pull request.

Feel free to open issues for bugs :)

This project is licensed under the MIT License - see the LICENSE file for details.