Modular TypeScript framework for building LLM-powered apps. From raw streaming to a full coding agent.
Each package works on its own. Stack them together and you get a full coding agent—or a manager that drives many agents at once.
| Package | What it does | README |
|---|---|---|
@kleio/ai |
Unified LLM streaming API across four providers | packages/gg-ai |
@kleio/agent |
Agent loop with multi-turn tool execution | packages/gg-agent |
@kleio/coder |
Kleio Coder CLI with OAuth, tools, and TUI | packages/ggcoder |
@kleio/manager |
Kleio Manager orchestration for many Kleio Coder workers | packages/gg-boss |
@kleio/ai (standalone)
└─► @kleio/agent
└─► @kleio/coder
└─► @kleio/manager (orchestrates many Kleio Coder workers)
| You want to... | Use |
|---|---|
| Stream LLM responses across providers with one API | @kleio/ai |
| Build an agent that calls tools and loops autonomously | @kleio/agent |
| Use a ready-made CLI coding agent | @kleio/coder |
| Drive many coding agents across multiple projects from one chat | @kleio/manager |
Install only what you need:
npm i @kleio/ai # Streaming layer
npm i @kleio/agent # Streaming + agent loop
npm i -g @kleio/coder # Kleio Coder CLI
npm i -g @kleio/manager # Kleio Manager CLIThe preferred commands are kleio-coder and kleio-manager.
The legacy ggcoder and ggboss executables remain compatibility aliases for existing scripts and installations. They run the same entry points and use the same .gg state as kleio-coder and kleio-manager. Use the Kleio commands in new documentation and automation.
Repository directories remain packages/ggcoder and packages/gg-boss to preserve the upstream-sync seam.
git clone https://github.com/fmckie/gg-framework.git
cd gg-framework
pnpm install
pnpm buildTypeScript 5.9 + pnpm workspaces + Ink 6 + React 19 + Vitest 4 + Zod v4
MIT
Less bloat. More coding. One Kleio framework.
