[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-2987":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":35,"readmeContent":36,"aiSummary":37,"trendingCount":15,"starSnapshotCount":15,"syncStatus":38,"lastSyncTime":39,"discoverSource":40},2987,"code-helm","humeo\u002Fcode-helm","humeo","Control your local Codex sessions remotely through Discord on your phone or browser.","",null,"TypeScript",237,1,87,0,47,45.6,"MIT License",false,"main",true,[23,24,25,26,27,28,29,30,31,32,33,34],"ai-coding","automation","bun","cli","codex","coding-agent","developer-tools","discord-bot","local-first","openai-codex","remote-control","typescript","2026-06-12 04:00:16","\u003Cdiv align=\"center\">\n\n\u003Cimg src=\"docs\u002Fassets\u002Fcodehelm-product-banner.png\" alt=\"CodeHelm\" width=\"760\" \u002F>\n\n\u003Ch2>Run Codex locally. Control it from Discord.\u003C\u002Fh2>\n\n\u003Cp>\u003Cstrong>Approve, resume, interrupt, and monitor AI coding work from your phone.\u003C\u002Fstrong>\u003C\u002Fp>\n\n\u003Cp>\nCodeHelm lets you start, resume, approve, interrupt, and monitor local Codex\nsessions from a Discord thread.\n\u003C\u002Fp>\n\n[![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fcode-helm?style=flat-square&color=111827)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fcode-helm)\n[![Bun](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fruntime-Bun-000000?style=flat-square&logo=bun&logoColor=white)](https:\u002F\u002Fbun.sh)\n[![TypeScript](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTypeScript-5.9-3178C6?style=flat-square&logo=typescript&logoColor=white)](https:\u002F\u002Fwww.typescriptlang.org\u002F)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-control%20surface-5865F2?style=flat-square&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.com\u002Fdevelopers\u002Fdocs\u002Fintro)\n\n\u003Cbr \u002F>\n\n[English](README.md) · [中文](README.zh-CN.md)\n\n\u003Cbr \u002F>\n\n[Demo](#demo) · [Quick Start](#quick-start) · [Workflow](#workflow) · [Discord Setup](docs\u002Fdiscord-bot-setup.md) · [Development](#development)\n\n\u003C\u002Fdiv>\n\n## ⚡ Overview\n\nCodeHelm runs a local daemon, manages a local Codex App Server, and turns a\nDiscord channel into a control surface for Codex sessions. You can set a\nworkdir, start or resume a session, approve requests, interrupt a running turn,\nand follow progress in one Discord thread instead of bouncing between tools.\n\nPerfect for:\n\n- approving Codex actions while away from your terminal\n- keeping AI coding sessions visible to your team\n- resuming long-running sessions without losing context\n\n> You only need to: start CodeHelm locally, connect Codex to the printed remote\n> address, and use the configured Discord channel.\n>\n> CodeHelm will return: a managed Discord thread attached to a real Codex\n> session, with transcript updates, approval controls, and final output in one\n> place.\n\n## Demo\n\n\u003Cimg src=\"docs\u002Fdemo\u002F04-23-code-helm.gif\" alt=\"CodeHelm Discord remote-control demo\" width=\"100%\" \u002F>\n\n## Workflow\n\n1. **Start the local daemon**: CodeHelm connects to Discord and starts a managed\n   Codex App Server on loopback.\n2. **Connect Codex**: run `codex --remote \u003Cws-url>` with the address printed by\n   `code-helm start`.\n3. **Choose a workdir**: use `\u002Fworkdir` in the configured Discord control\n   channel.\n4. **Create or resume a session**: use `\u002Fsession-new` or `\u002Fsession-resume`.\n5. **Work inside the managed thread**: send follow-up messages, approve\n   requests, inspect status, interrupt turns, and read the final answer.\n\nEach managed Discord thread stays attached to one Codex session, so you can\nleave and come back later without starting from scratch.\n\n## Quick Start\n\n### Install\n\n#### Prerequisites\n\n| Tool or setup   | Requirement                                      | Check                                            |\n| --------------- | ------------------------------------------------ | ------------------------------------------------ |\n| Bun             | Installed on the machine running CodeHelm        | `bun --version`                                  |\n| Codex           | Installed on the same machine                    | `codex --version`                                |\n| Discord bot     | Bot token, target server, control channel        | [Discord setup guide](docs\u002Fdiscord-bot-setup.md) |\n| Discord channel | Text or announcement channel with public threads | Check channel permissions                        |\n| Bot intent      | `Message Content Intent` enabled                 | Discord Developer Portal                         |\n\n#### 1. Install CodeHelm\n\nChoose one install method:\n\n```bash\nnpm install -g code-helm\n```\n\n```bash\nbun add -g code-helm\n```\n\nBun is still required at runtime even if you install the package with `npm`.\n\n#### 2. Onboard Discord\n\n```bash\ncode-helm onboard\n```\n\nThe guided setup asks for:\n\n- your Discord bot token\n- the target guild\n- the control channel\n\n#### 3. Start CodeHelm\n\nForeground:\n\n```bash\ncode-helm start\n```\n\nBackground:\n\n```bash\ncode-helm start --daemon\n```\n\nBy default, CodeHelm starts the managed Codex App Server at `ws:\u002F\u002F127.0.0.1:4200`.\n\nIf that port is already in use, choose another port for this run:\n\n```bash\ncode-helm start --port 4201\ncode-helm start --daemon --port 4201\n```\n\n#### 4. Connect Codex\n\nUse the address printed by `code-helm start`:\n\n```bash\ncodex --remote \u003Cws-url>\n```\n\nIf you want Codex to start in your current shell directory:\n\n```bash\ncodex -C \"$(pwd)\" --remote \u003Cws-url>\n```\n\n#### 5. Control Sessions From Discord\n\nControl-channel commands:\n\n| Command           | Purpose                                   |\n| ----------------- | ----------------------------------------- |\n| `\u002Fworkdir`        | Set the current local workdir             |\n| `\u002Fsession-new`    | Start a fresh Codex session               |\n| `\u002Fsession-resume` | Reattach an existing Codex session        |\n| `\u002Fsession-close`  | Close the current managed session thread  |\n| `\u002Fsession-sync`   | Recover a degraded managed session thread |\n\nManaged-thread commands and actions:\n\n| Command or action            | Purpose                                 |\n| ---------------------------- | --------------------------------------- |\n| Send a normal thread message | Continue the Codex conversation         |\n| Approval buttons             | Approve or decline Codex requests       |\n| `\u002Fstatus`                    | Show the current managed session status |\n| `\u002Finterrupt`                 | Interrupt the current Codex turn        |\n\n## Commands\n\n| Command                         | Purpose                                      |\n| ------------------------------- | -------------------------------------------- |\n| `code-helm onboard`             | Configure the Discord bot and control channel |\n| `code-helm start`               | Run CodeHelm in the foreground               |\n| `code-helm start --daemon`      | Run CodeHelm in the background               |\n| `code-helm status`              | Show daemon state and the Codex remote URL   |\n| `code-helm stop`                | Stop the background daemon                   |\n| `code-helm check`               | Check whether a newer package is available   |\n| `code-helm update`              | Update the installed package                 |\n| `code-helm autostart enable`    | Start the daemon at login on macOS           |\n| `code-helm autostart disable`   | Remove the login-startup entry on macOS      |\n| `code-helm uninstall`           | Remove local CodeHelm config, state, and db  |\n| `code-helm version`             | Print the installed version                  |\n\n## Development\n\nFor local repository development:\n\n```bash\nbun install\nbun test\nbun run typecheck\n```\n\nUseful development commands:\n\n```bash\nbun run dev\nbun run migrate\n```\n","CodeHelm 是一个允许用户通过 Discord 在手机或浏览器上远程控制本地 Codex 会话的工具。它使用 TypeScript 编写，基于 Bun 运行时环境，并提供了一个 CLI 接口来管理本地 Codex 应用服务器。核心功能包括从 Discord 频道启动、恢复、批准、中断和监控 AI 编码任务，使得开发者即使不在终端前也能方便地操作。适用于需要团队协作或者长时间运行的编码场景中，让开发人员能够更灵活地管理和监督 AI 辅助编程过程。",2,"2026-06-11 02:52:03","CREATED_QUERY"]