{"id":36169971,"url":"https://github.com/chatml/chatml","last_synced_at":"2026-04-01T17:42:31.597Z","repository":{"id":342098495,"uuid":"1137653568","full_name":"chatml/chatml","owner":"chatml","description":"AI Agent Orchestrator for Claude Code","archived":false,"fork":false,"pushed_at":"2026-03-24T20:12:31.000Z","size":108722,"stargazers_count":39,"open_issues_count":18,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-03-24T20:56:49.956Z","etag":null,"topics":["agentic-ai","claude-code","go","rust","tauri2"],"latest_commit_sha":null,"homepage":"https://chatml.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chatml.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":"CLA.md"}},"created_at":"2026-01-19T16:47:03.000Z","updated_at":"2026-03-24T20:12:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/chatml/chatml","commit_stats":null,"previous_names":["chatml/chatml"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/chatml/chatml","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chatml%2Fchatml","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chatml%2Fchatml/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chatml%2Fchatml/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chatml%2Fchatml/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chatml","download_url":"https://codeload.github.com/chatml/chatml/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chatml%2Fchatml/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290549,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","claude-code","go","rust","tauri2"],"created_at":"2026-01-11T01:28:01.868Z","updated_at":"2026-04-01T17:42:31.592Z","avatar_url":"https://github.com/chatml.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"public/mascot.png\" width=\"300\" alt=\"ChatML mascot\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eChatML\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eRun AI coding agents in parallel. Each task gets its own worktree.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/chatml/chatml/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/chatml/chatml?style=flat-square\" alt=\"Release\" /\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-GPL--3.0-blue?style=flat-square\" alt=\"License\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/chatml/chatml/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/chatml/chatml/ci.yml?branch=main\u0026style=flat-square\u0026label=CI\" alt=\"CI\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/chatml/chatml/releases\"\u003e\u003cimg src=\"https://img.shields.io/badge/platform-macOS-lightgrey?style=flat-square\" alt=\"Platform\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://x.com/chatmlx\"\u003e\u003cimg src=\"https://img.shields.io/badge/follow-%40chatmlx-black?style=flat-square\u0026logo=x\" alt=\"Follow @chatmlx\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"docs/assets/screenshot-readme-1.png\" width=\"880\" alt=\"ChatML — AI coding agents running in parallel with isolated worktrees\" /\u003e\u003c/p\u003e\n\n---\n\nChatML is a native macOS app for AI-assisted development. Instead of chatting with an AI and copy-pasting code, you describe a task and Claude does the work — reading files, writing code, running commands, and creating PRs — all inside an isolated git worktree so nothing touches your working directory.\n\nSpin up five sessions at once: one refactoring auth, one adding an API endpoint, one fixing a bug, one writing tests, one reviewing a PR. They all run in parallel without stepping on each other.\n\n## How It Works\n\n```\n1. Add a repo          →  Register any git repository as a workspace\n2. Create a session    →  ChatML creates an isolated worktree + branch\n3. Describe the task   →  Claude writes, edits, and runs code directly\n4. Review \u0026 merge      →  Check the diff, open a PR, done\n```\n\nSessions are fully isolated. Each one gets its own branch, its own working directory, and its own AI agent. No merge conflicts between parallel tasks.\n\n## Download\n\n**[Download the latest release](https://github.com/chatml/chatml/releases)** (.dmg for macOS)\n\nOr build from source:\n\n```bash\ngit clone https://github.com/chatml/chatml.git \u0026\u0026 cd chatml \u0026\u0026 make dev\n```\n\nYou'll need an [Anthropic API key](https://console.anthropic.com/) — the onboarding wizard will walk you through setup.\n\n## Key Features\n\n### Worktree-Isolated Sessions\n\nEvery session creates a `git worktree` with its own branch and working directory. Sessions are fully isolated — no merge conflicts between parallel tasks, no accidentally committing to the wrong branch.\n\n### Full Agent Autonomy\n\nPowered by the [Claude Agent SDK](https://docs.anthropic.com). Claude has full tool access within each session: reading and writing files, running terminal commands, searching the codebase, and executing multi-step workflows. Watch everything happen in real time — text streams as it's generated, tool calls show their status and duration, sub-agents are tracked independently.\n\n### Built-In Code Review\n\nStart a review conversation and Claude examines the session's changes with inline comments, severity levels, and resolution tracking.\n\n### Pull Requests \u0026 CI/CD\n\nPush a branch and create a GitHub PR without leaving the app. Claude generates PR descriptions from the diff. Live status polling tracks checks, merge conflicts, and review state. View GitHub Actions runs, drill into job logs, and let Claude analyze failures.\n\n### Skills Marketplace\n\n25+ specialized prompt templates: TDD guidance, security audits, systematic debugging, architecture decision records, and more. Install per-session, or create your own.\n\n### Budget \u0026 Context Controls\n\nSet cost limits, turn limits, and thinking token budgets. Monitor context window utilization and token usage in real time. Automatic git stash-based checkpoints let you revert to any previous state.\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eAll Features\u003c/strong\u003e\u003c/summary\u003e\n\n- **File browser \u0026 editor** — Session-scoped tabs, syntax highlighting, side-by-side diffs, direct editing\n- **Terminal integration** — Full PTY terminal emulation, up to 5 terminals per session\n- **Extended thinking \u0026 plan mode** — Control how deeply Claude reasons before acting\n- **Linear integration** — OAuth-based issue discovery, context, and management\n- **MCP support** — Built-in server + custom MCP server configuration (stdio, SSE, HTTP)\n- **Session management** — Priority, status tracking, pinning, archiving with AI-generated summaries\n- **Branch sync** — Detect when behind `origin/main`, sync via rebase or merge\n- **Checkpointing \u0026 rewind** — Automatic checkpoints, revert files to any previous state\n- **Keyboard shortcuts** — 30+ shortcuts for fast navigation\n- **Auto-update** — Automatic update detection and installation\n\n\u003c/details\u003e\n\n## How It Compares\n\n| | ChatML | Cursor / Windsurf | Claude Code CLI | GitHub Copilot |\n|---|---|---|---|---|\n| **Parallel tasks** | Each task in its own worktree | Single workspace | Single terminal session | Single file context |\n| **Agent autonomy** | Full tool access: file I/O, terminal, git | Editor-integrated suggestions | Full tool access | Inline completions |\n| **Code review** | Built-in with inline comments | External | External | External |\n| **CI/CD monitoring** | GitHub Actions integration | External | External | External |\n| **PR workflow** | Create, track, merge natively | External | External | GitHub integration |\n| **Open source** | GPL-3.0 | Proprietary | Proprietary | Proprietary |\n\n## Architecture\n\nChatML is a polyglot app with four layers:\n\n```\n┌─────────────────────────────────────────────┐\n│              Tauri 2 (Rust)                 │\n│         Native macOS Desktop Shell          │\n│                                             │\n│  ┌───────────────┐  ┌───────────────────┐   │\n│  │  Next.js 15   │  │   Go Backend      │   │\n│  │  React 19     │◄─►  REST + WebSocket │   │\n│  │  Tailwind 4   │  │  SQLite           │   │\n│  │  Zustand      │  │  Git Operations   │   │\n│  └───────────────┘  └────────┬──────────┘   │\n│                              │              │\n│                     ┌────────▼──────────┐   │\n│                     │  Agent Runner     │   │\n│                     │  Node.js + Claude │   │\n│                     │  Agent SDK        │   │\n│                     └───────────────────┘   │\n└─────────────────────────────────────────────┘\n```\n\n| Layer | Tech | Role |\n|-------|------|------|\n| **Desktop Shell** | Tauri 2, Rust | Native window, menus, PTY, secure storage, auto-update |\n| **Frontend** | Next.js 15, React 19, Tailwind CSS 4 | UI, state management, WebSocket client |\n| **Backend** | Go, SQLite | REST API, WebSocket, git operations, agent lifecycle |\n| **Agent Runner** | Node.js, Claude Agent SDK | AI agent processes, tool execution, streaming |\n\nFor deeper technical details, see the [architecture documentation](docs/overview.md).\n\n## Contributing\n\nWe welcome contributions! Whether it's bug fixes, new features, documentation, or design work — there's plenty to do.\n\n```bash\n# Fork the repo, then:\ngit clone https://github.com/YOUR_USERNAME/chatml.git\ncd chatml\nmake dev\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for the full development setup, OAuth configuration, and PR process.\n\n### Areas Where Help is Needed\n\n- **Cross-platform support** — Linux and Windows builds\n- **Testing** — Frontend component tests, E2E tests\n- **Multi-model support** — Providers beyond Claude\n- **Documentation** — Guides, tutorials, API docs\n- **UI/UX** — Design improvements, accessibility\n- **Agent capabilities** — New skills, MCP integrations\n\nLooking for a place to start? Check [good first issues](https://github.com/chatml/chatml/labels/good%20first%20issue).\n\n### CLA Requirement\n\nWe require all contributors to sign a [Contributor License Agreement](CLA.md) before we can accept contributions. This is handled automatically when you open your first PR.\n\n## Roadmap\n\n- [ ] **Linux \u0026 Windows support** — Cross-platform desktop builds\n- [ ] **Multi-model support** — Use different AI providers beyond Claude\n- [ ] **Team collaboration** — Shared workspaces and session handoff\n- [ ] **Plugin system** — Community-built skills and integrations\n- [ ] **Self-hosted backend** — Run the backend as a standalone server\n- [ ] **Voice interaction** — Talk to your agent\n\nWant to help with any of these? [Open an issue](https://github.com/chatml/chatml/issues) or jump into a [discussion](https://github.com/chatml/chatml/discussions).\n\n## Security\n\nAPI keys are stored encrypted with AES-256-GCM. Agent sessions run in isolated worktrees. No telemetry. All communication stays on localhost.\n\nSee [SECURITY.md](SECURITY.md) for our security policy and how to report vulnerabilities.\n\n## License\n\nChatML is licensed under the [GNU General Public License v3.0](LICENSE). You are free to use, modify, and distribute this software, provided that derivative works are distributed under the same license.\n\n---\n\n\u003cp align=\"center\"\u003e⭐ If you find this interesting, please star the repo.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Built with obsessive attention to developer workflow.\u003cbr /\u003e\n  \u003ca href=\"https://github.com/chatml/chatml/issues\"\u003eReport a Bug\u003c/a\u003e · \u003ca href=\"https://github.com/chatml/chatml/issues\"\u003eRequest a Feature\u003c/a\u003e · \u003ca href=\"https://github.com/chatml/chatml/discussions\"\u003eDiscussions\u003c/a\u003e · \u003ca href=\"https://x.com/chatmlx\"\u003e@chatmlx\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchatml%2Fchatml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchatml%2Fchatml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchatml%2Fchatml/lists"}