Skip to content

docs: optimize README — minimal quick start, agent guides in docs/#268

Merged
thepagent merged 1 commit intoopenabdev:mainfrom
chaodu-agent:docs/optimize-readme
Apr 13, 2026
Merged

docs: optimize README — minimal quick start, agent guides in docs/#268
thepagent merged 1 commit intoopenabdev:mainfrom
chaodu-agent:docs/optimize-readme

Conversation

@chaodu-agent
Copy link
Copy Markdown
Collaborator

What

README was getting cluttered as more CLI agents were added. This PR restructures documentation to keep the README minimal.

Changes

README.md (280 → 198 lines):

  • Quick Start now shows only Kiro CLI (default)
  • Removed Claude Code / Codex / Gemini / multi-agent Helm examples
  • Added agent table with links to individual docs
  • Simplified Pod Architecture diagram (ASCII art)
  • Collapsed reactions config into <details> tag
  • Removed per-agent manual config.toml examples

New docs/:

  • docs/kiro.md — Kiro CLI install, config, auth
  • docs/claude-code.md — Claude Code install, config, auth
  • docs/codex.md — Codex install, config, auth
  • docs/gemini.md — Gemini CLI install, config, auth
  • docs/multi-agent.md — Multi-agent Helm setup (advanced)

Why

As we add more agents (Copilot, OpenCode, etc.), the README should stay clean. New users see the default (Kiro) quick start immediately. Advanced users follow links to the specific agent they need.

No code changes — docs only.

…o docs/

- README now shows only Kiro CLI (default) quick start
- Each agent (Claude Code, Codex, Gemini) gets its own docs/<agent>.md
- Multi-agent Helm setup moved to docs/multi-agent.md
- Simplified Pod Architecture diagram
- Collapsed reactions config into <details> tag
- Added agent table with links to individual guides
@chaodu-agent chaodu-agent requested a review from thepagent as a code owner April 13, 2026 05:16
@thepagent thepagent merged commit 9f49d1f into openabdev:main Apr 13, 2026
Reese-max pushed a commit to Reese-max/openab that referenced this pull request Apr 14, 2026
…o docs/ (openabdev#268)

- README now shows only Kiro CLI (default) quick start
- Each agent (Claude Code, Codex, Gemini) gets its own docs/<agent>.md
- Multi-agent Helm setup moved to docs/multi-agent.md
- Simplified Pod Architecture diagram
- Collapsed reactions config into <details> tag
- Added agent table with links to individual guides

Co-authored-by: 超渡法師 <chaodu-agent@openab.dev>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants