{"id":48290763,"url":"https://github.com/nczz/kiro-discord-bot","last_synced_at":"2026-06-29T05:01:00.757Z","repository":{"id":346288186,"uuid":"1188057635","full_name":"nczz/kiro-discord-bot","owner":"nczz","description":"A trainable AI agent that lives in Discord — binds to your codebase, remembers your rules, and gets smarter the more you use it.","archived":false,"fork":false,"pushed_at":"2026-06-23T18:36:55.000Z","size":1579,"stargazers_count":26,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-23T20:21:34.346Z","etag":null,"topics":["acp","agent-client-protocol","ai-agent","automation","chatops","coding-assistant","cron","devops","discord-bot","golang","kiro","kiro-cli","multi-agent"],"latest_commit_sha":null,"homepage":"https://kiro.dev","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nczz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"audit/recorder.go","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":null}},"created_at":"2026-03-21T15:03:51.000Z","updated_at":"2026-06-23T18:37:48.000Z","dependencies_parsed_at":"2026-04-20T05:03:53.235Z","dependency_job_id":null,"html_url":"https://github.com/nczz/kiro-discord-bot","commit_stats":null,"previous_names":["nczz/kiro-discord-bot"],"tags_count":40,"template":false,"template_full_name":null,"purl":"pkg:github/nczz/kiro-discord-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nczz%2Fkiro-discord-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nczz%2Fkiro-discord-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nczz%2Fkiro-discord-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nczz%2Fkiro-discord-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nczz","download_url":"https://codeload.github.com/nczz/kiro-discord-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nczz%2Fkiro-discord-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34913586,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-29T02:00:05.398Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["acp","agent-client-protocol","ai-agent","automation","chatops","coding-assistant","cron","devops","discord-bot","golang","kiro","kiro-cli","multi-agent"],"created_at":"2026-04-04T23:05:39.153Z","updated_at":"2026-06-29T05:01:00.750Z","avatar_url":"https://github.com/nczz.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kiro-discord-bot\n\n[繁體中文 README](README.zh-TW.md) | [Full documentation][docs]\n\n**A Discord bot and control plane for project-bound ACP agents.**\n\n`kiro-discord-bot` connects Discord channels and threads to ACP-compatible coding agents over stdio. Kiro CLI is the default engine, while OMP can be enabled as an optional replacement behind the same Discord commands, MCP policy, audit, usage, cron, memory, and thread-agent controls.\n\nEach initialized channel can bind to a real project directory, keep its own agent session, remember project guidance, and expose Model Context Protocol (MCP) tools through explicit channel policy.\n\nThis repository README is intentionally short. The detailed user guide, admin guide, MCP setup, release runbook, and troubleshooting docs live on the [documentation site][docs].\n\n## Why It Is Different\n\n- **Project-bound ACP agents**: each Discord channel maps to a working directory and an agent session.\n- **Engine flexibility**: keep Kiro as the default, or enable OMP for selected channels and threads without changing the Discord workflow.\n- **Trainable context**: use memory, flash memory, steering files, conversation history, and project knowledge instead of starting from zero every time.\n- **Safe tool expansion**: MCP servers are discovered as a catalog, then exposed per channel through policy and a proxy.\n- **Operational controls**: admin panels and sensitive diagnostics use private replies where Discord supports them.\n- **Automation**: cron jobs and reminders let an agent run scheduled work under channel ownership.\n\n## Quick Start\n\n1. Install and authenticate at least one ACP engine: `kiro-cli` or `omp`.\n2. Create a Discord bot with `bot` and `applications.commands` scopes, Message Content Intent, and the required channel/message permissions.\n3. Download the latest release archive or build from source.\n4. Provide environment variables such as `DISCORD_TOKEN`, `DISCORD_GUILD_ID`, `DEFAULT_CWD`, and `DATA_DIR`.\n5. Run the bot once in the foreground and confirm it logs in.\n6. In Discord, run `/cwd` in a channel to bind it to a project.\n7. Run `/doctor` to verify permissions and enabled engine readiness.\n\nContinue with the [full installation guide][install-doc].\n\n## Common Docs\n\n| Topic | Start here |\n| --- | --- |\n| First-time setup | [Getting Started][getting-started] · [Installation][install-doc] |\n| Daily use | [Command Reference][commands] · [Listen Modes][listen-modes] |\n| Agent engines | [Agent Engines][agent-engines] · [Environment][environment] |\n| Agent context | [Steering Files][steering] · [Core Concepts][core-concepts] |\n| Tool access | [MCP Policy][mcp] · [Bot Tools][bot-tools] · [Discord MCP Server][mcp-discord] |\n| Operations | [Environment][environment] · [Deployment][deployment] · [Release Runbook][release] |\n| Security and review | [Security Model][security] · [Audit, Usage, and Privacy][audit-usage] |\n| Support | [Troubleshooting][troubleshooting] · [macOS MCP Networking][macos-networking] |\n\n## Build From Source\n\n```bash\nVERSION=$(git describe --tags --always 2\u003e/dev/null || echo \"dev\")\ngo build -ldflags \"-X main.Version=$VERSION\" -o kiro-discord-bot .\ngo build -o mcp-discord-server ./cmd/mcp-discord\ngo build -o mcp-media-server ./cmd/mcp-media\n```\n\n## Release and Operations\n\nRun the release preflight before tagging or deploying:\n\n```bash\nscripts/release-preflight.sh\n```\n\nFollow the [release runbook][release] for tagging, publishing, deployment, and rollback.\n\n## License\n\nMIT\n\n[docs]: https://nczz.github.io/kiro-discord-bot/\n[getting-started]: https://nczz.github.io/kiro-discord-bot/guide/getting-started.html\n[install-doc]: https://nczz.github.io/kiro-discord-bot/guide/installation.html\n[agent-engines]: https://nczz.github.io/kiro-discord-bot/guide/agent-engines.html\n[commands]: https://nczz.github.io/kiro-discord-bot/guide/commands.html\n[listen-modes]: https://nczz.github.io/kiro-discord-bot/guide/listen-modes.html\n[core-concepts]: https://nczz.github.io/kiro-discord-bot/guide/core-concepts.html\n[steering]: https://nczz.github.io/kiro-discord-bot/guide/steering.html\n[mcp]: https://nczz.github.io/kiro-discord-bot/guide/mcp.html\n[bot-tools]: https://nczz.github.io/kiro-discord-bot/guide/bot-tools.html\n[mcp-discord]: https://nczz.github.io/kiro-discord-bot/guide/mcp-discord.html\n[environment]: https://nczz.github.io/kiro-discord-bot/guide/environment.html\n[deployment]: https://nczz.github.io/kiro-discord-bot/guide/deployment.html\n[release]: https://nczz.github.io/kiro-discord-bot/guide/release.html\n[security]: https://nczz.github.io/kiro-discord-bot/guide/security-model.html\n[audit-usage]: https://nczz.github.io/kiro-discord-bot/guide/audit-usage-privacy.html\n[troubleshooting]: https://nczz.github.io/kiro-discord-bot/guide/troubleshooting.html\n[macos-networking]: https://nczz.github.io/kiro-discord-bot/guide/macos-mcp-networking.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnczz%2Fkiro-discord-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnczz%2Fkiro-discord-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnczz%2Fkiro-discord-bot/lists"}