\n Open-source AI agent sessions for desktop, server, and terminal\n
\n\n
\n \n \n \n \n
\n\n---\n\nKata Agents is a desktop app, headless server, and CLI client for running AI agent sessions. It connects to multiple AI providers, executes tools against your local workspace, and streams results in real time.\n\n## Features\n\n- **Multi-provider AI** — Claude (Anthropic API, Max/Pro OAuth, Bedrock), OpenAI, Google AI Studio, GitHub Copilot, OpenRouter, Ollama, and any OpenAI-compatible endpoint\n- **Desktop app** — Electron + React GUI with a multi-session inbox, file attachments, real-time streaming, and workspace management\n- **Headless server** — WebSocket RPC server (port 9100) for remote or automated agent sessions\n- **CLI client** — `kata-agents-cli` connects to any running server and supports scripted workflows\n- **Sources** — Attach live data connections (MCP, API, local) to agent sessions\n- **Skills** — Define custom `SKILL.md` files to extend agent behavior per workspace\n- **Automations** — Event-driven automations across sessions and messaging platforms\n- **Secure credentials** — AES-256-GCM encrypted credential storage at `~/.kata-agents/`\n- **Internationalized** — 7 locales: English, German, Spanish, Hungarian, Japanese, Polish, Simplified Chinese\n\n## Installation\n\n### Desktop app\n\nDownload the latest installer from the [Releases](https://github.com/gannonh/kata-agents/releases/latest) page and run it for your platform:\n\n| Platform | File |\n|---|---|\n| macOS (Apple Silicon) | `Kata-Agents-arm64.dmg` |\n| macOS (Intel) | `Kata-Agents-x64.dmg` |\n| Linux | `Kata-Agents-x64.AppImage` |\n| Windows | `Kata-Agents-Setup.exe` |\n\n> [!NOTE]\n> Kata Agents ships on two channels. **Stable** releases are tagged `vX.Y.Z` and marked as latest. **Nightly** builds are published as pre-releases tagged `vX.Y.Z-nightly.YYYYMMDD.N`. Once installed, switch channels any time in **Settings → About → Update track** — the app checks and applies updates automatically.\n\n### Build from source\n\nRequires [Bun](https://bun.sh/) and Node.js 18+.\n\n```bash\ngit clone https://github.com/gannonh/kata-agents.git\ncd kata-agents\nbun install\ncp .env.example .env # add your API keys\nbun run electron:start # build and launch\n```\n\nFor hot-reload development:\n\n```bash\nbun run electron:dev\n```\n\n### Headless server\n\nRun the agent server without the desktop GUI — useful for CI, remote access, or containerized deployments:\n\n```bash\n# Run from source\nbun run server:start\n\n# Docker\ndocker build -f Dockerfile.server -t kata-agents-server .\ndocker run -p 9100:9100 kata-agents-server\n```\n\nThe server exposes a WebSocket RPC API at `ws://localhost:9100`. TLS is supported via `KATA_RPC_TLS_CERT` / `KATA_RPC_TLS_KEY`.\n\n### CLI client\n\n`kata-agents-cli` connects to any running server:\n\n```bash\n# Link globally\ncd apps/cli && bun link\nkata-agents-cli ping # verify connectivity\nkata-agents-cli sessions # list sessions\nkata-agents-cli send \"Hello\" # stream a message\n\n# Self-contained run (no server setup needed)\nANTHROPIC_API_KEY=sk-... kata-agents-cli run \"Summarize this repo\"\n```\n\nSee [CLI Reference](docs/reference/cli.md) for the full command surface.\n\n## AI Providers\n\nKata Agents supports two agent backends:\n\n### Claude (primary)\n\nPowered by `@anthropic-ai/claude-agent-sdk`. Supports:\n\n| Auth method | Setup |\n|---|---|\n| Anthropic API key | Set `ANTHROPIC_API_KEY` |\n| Claude Max/Pro OAuth | Sign in via the desktop app |\n| AWS Bedrock | Set `CLAUDE_CODE_USE_BEDROCK` + AWS credentials |\n| Custom endpoint | Set base URL in Settings → AI (OpenRouter, Vercel AI Gateway, etc.) |\n\n### Pi SDK\n\nHandles non-Anthropic providers:\n\n| Provider | Auth |\n|---|---|\n| Google AI Studio | API key |\n| ChatGPT Plus (Codex) | OAuth |\n| GitHub Copilot | OAuth |\n| OpenAI | API key |\n| Ollama / custom OpenAI-compatible | Base URL |\n\n## Configuration\n\nRuntime config lives at `~/.kata-agents/`:\n\n```\n~/.kata-agents/\n├── config.json # workspaces and LLM connections\n├── credentials.enc # encrypted credentials\n├── preferences.json # UI preferences (language, theme)\n└── workspaces/{id}/\n ├── sessions/ # session JSONL history\n ├── sources/ # connected data sources\n ├── skills/ # custom SKILL.md files\n ├── statuses/ # workflow status definitions\n └── automations.json\n```\n\n**Permission modes:** `safe` | `ask` | `allow-all`\n\n**Source types:** `mcp` | `api` | `local`\n\n## Development\n\n```bash\nbun run typecheck:all # type-check all packages\nbun test # run all tests\nbun run lint # lint all packages\nbun run validate:ci # full CI validation (types + tests + i18n)\n```\n\n**i18n:** All user-facing strings go through `t()` / `i18n.t()`. Keys must exist in all 7 locale files, sorted alphabetically. Run `bun run lint:i18n:parity` and `bun run lint:i18n:sorted` to verify.\n\n**Releases:** The CI pipeline builds signed/notarized macOS binaries and unsigned Windows/Linux builds, published to GitHub Releases. See [operations/release.md](docs/operations/release.md) for the full pipeline reference.\n\n## Architecture\n\nKata Agents is organized as a Bun monorepo:\n\n```\nkata-agents/\n├── apps/\n│ ├── electron/ # desktop app (Electron + React + Vite)\n│ ├── cli/ # terminal client\n│ ├── viewer/ # shared session viewer\n│ └── webui/ # web UI\n└── packages/\n ├── core/ # shared types\n ├── shared/ # business logic (agent, auth, config, credentials)\n ├── ui/ # React components (shadcn/ui + Tailwind CSS v4)\n ├── server/ # headless server entry point\n ├── server-core/ # server core logic\n ├── pi-agent-server/ # Pi SDK subprocess\n ├── session-mcp-server/ # MCP server for session tools\n ├── session-tools-core/ # session tool implementations\n ├── messaging-gateway/ # Telegram and messaging integrations\n └── messaging-whatsapp-worker/ # WhatsApp worker\n```\n\nThe Electron renderer communicates with the main process over a typed IPC bridge. Agent subprocesses run separately — the Claude SDK spawns a native binary; the Pi SDK runs under Bun with a network interceptor preloaded. Both connect to the same WebSocket RPC layer used by the headless server and CLI.\n\nSee [docs/architecture/system-overview.md](docs/architecture/system-overview.md) for a detailed map.\n\n## Documentation\n\n| | |\n|---|---|\n| [Online Docs Site](apps/online-docs) | Mintlify source for the hosted product documentation |\n| [Architecture Overview](docs/architecture/system-overview.md) | System map, package responsibilities, agent backends |\n| [CLI Reference](docs/reference/cli.md) | Full `kata-agents-cli` command surface and flags |\n| [CI Pipeline](docs/operations/ci.md) | GitHub Actions CI setup |\n| [Release Pipeline](docs/operations/release.md) | Nightly/stable release process and required secrets |\n| [Contributing](CONTRIBUTING.md) | Branch naming, PR process, code style |\n| [Security](SECURITY.md) | Security policy and vulnerability disclosure |\n\n## License\n\nApache 2.0 — see [LICENSE](LICENSE).\n",
"bytes": 7822,
"sha": "fc729cb744e54f2b38eac30e6243fdafd2782e11afea400f3414ee199761042d",
"repo_slug": "gannonh/kata-agents",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/okf_gannonh_kata_agents_docs_index_md_ba4df4fc/readme"
}
![\"Kata](\"apps/electron/resources/icon.svg\"){kind=icon}
\n![\"CI\"](\"https://github.com/gannonh/kata-agents/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n ![\"License:](\"https://img.shields.io/badge/license-Apache%202.0-blue.svg\"){kind=icon}
\n ![\"Runtime:](\"https://img.shields.io/badge/runtime-Bun-black.svg\"){kind=icon}
\n ![\"Platform\"](\"https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey.svg\"){kind=icon}
\n