Skip to content

wildcrane-ai/wildcrane

v0.1.19

Shape goals with Codex and start them as WildCrane tasks, run on this computer.

GitHubOpen Website

WildCrane for Codex

Shape goals with Codex in your own session and start them as WildCrane tasks, run on this computer. No separate Runner to install: the plugin starts this computer's Runner, downloading it on first start, and the Runner updates itself.

  • 看板与技能：通过插件连接云端项目；Runner 在绑定目录和运行任务时把 kanban 技能写入项目，无需手动安装，并维护提交保护，保留用户文件和已有钩子。

  • Needs: Codex 0.159 or later, and Node 22 or later (found on the PATH or in the usual nvm, Volta, Homebrew, fnm, asdf and mise places).

  • Goals: tell Codex what you want to build; it asks in the conversation and saves the goals, replying with one line and a link per goal. Review, change the studio, discard and Start on the web: Codex never starts a task.

  • Settings: $wildcrane opens this computer's settings in the browser — sign-in, project folders and AI tools.

  • Ask Codex: to sign in, to add this folder as a new or existing project, or for your projects, recent discussions and agent connections.

  • Updates: when a newer plugin is released, Codex mentions it the first time you ask for your WildCrane status in a conversation. An install from an unzipped folder is told how to switch.

  • akb: when none is installed, Codex is told the full path of the Runner's, which finds the board of a folder added to a project. Not on Windows.

  • Approvals: Codex asks before each WildCrane tool call unless you approve it for the session.

Install

codex plugin marketplace add wildcrane-ai/wildcrane --ref codex-plugin
codex plugin add wildcrane@wildcrane

Update

codex plugin marketplace upgrade wildcrane

Then restart Codex. Each plugin-v* release adds the built plugin to the codex-plugin branch.

Develop

cd runner && npm install && npm run build      # writes runner/dist/ and plugins/*/server/dist/start.mjs
export WILDCRANE_RUNNER_DIR=$PWD               # Codex runs this checkout's Runner
codex plugin marketplace add ./plugins
codex plugin add wildcrane@wildcrane

After a rebuild, codex plugin remove wildcrane@wildcrane and add it again: Codex runs a copy.

Check it

cd runner && npm test                          # the component's tools, lock and lifecycle
plugins/codex/server/bin/wildcrane codex </dev/null && echo started

运行电脑设置

要求 Codex“打开 WildCrane 设置”，通过 wildcrane_open_settings({ path?, project? }) 打开共用页面。参数仅预填上下文，不授予目录权限。原有 wildcrane_sign_in 和 wildcrane_add_folder 保持兼容；新配置优先在设置页完成。