Home

bash-agent Wiki

bash-agent is a terminal agent runtime built from a small Bash reference implementation and kept aligned across Bash, C, Go, and Rust. The wiki is organized as a course first, with deeper design notes kept as reference material.

Course

• English Course
  Build an agent step by step, starting from a minimal Bash loop and ending with tools, sessions, sub-agents, compaction, and runtime parity.

• 中文课程
  从一个最小 Bash Agent 循环开始，逐步加入流式响应、工具调用、会话存储、子 Agent、动态压缩和多运行时同构。

Design Notes

These pages keep the stable design details behind specific subsystems. Existing URLs are preserved.

• Cache-Aligned Summarization
• Dynamic Compaction Decision: When to Compact and How Much to Keep
• Bash Tool Permission Mode

中文设计笔记

• 缓存对齐摘要
• 动态压缩决策：何时压缩？保留多少？
• Bash 工具权限模式（BASH_AGENT_BASH_MODE）

Project Links

• Repository
• Website
• Releases