← KombaiCONTENT HISTORY

Update to Kombai

Snapshot Nov 9, 2026 · 06:07 UTC · version 0.5.0

Collection source: downloaded plugin package.

WHAT CHANGED

First saved snapshot

No earlier snapshot is available to establish a change.

Save Kombai and check future changes in Following.

Up to 3 plugins free · no card required.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "Kombai's onboarding in Codex. Sets Kombai's canvas view up if this Codex doesn't have it yet, checks the user is signed in, and shows prompts to try in a new chat. Run by the plugin's setup and by Codex's Try now after an install, and whenever the user asks to set Kombai up, get started with it, or see what to try. Not for design requests; those are work-with-kombai's.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 165
    }
  ],
  "name": "get-started-with-kombai",
  "skill_md_contents": "---\nname: get-started-with-kombai\ndescription: Kombai's onboarding in Codex. Sets Kombai's canvas view up if this Codex doesn't have it yet, checks the user is signed in, and shows prompts to try in a new chat. Run by the plugin's setup and by Codex's Try now after an install, and whenever the user asks to set Kombai up, get started with it, or see what to try. Not for design requests; those are work-with-kombai's.\n---\n\nWhen running in Codex's sandbox, request approved execution outside it **before the first\ncommand below** and for every later Kombai CLI command. Use\n`sandbox_permissions: \"require_escalated\"` on the execution tool call. The commands need network\naccess and write `~/.kombai` and Codex's `config.toml`; `npx` may contact the package registry before Kombai\nstarts. Do not try the restricted command first. If this chat cannot approve the required access,\nexplain the restriction and wait for the user to change its permissions; do not retry inside\nthe sandbox.\n\nThe user can run this as often as they like. Do each step without asking first, and do no design work here.\n\nKombai's plugin id in this Codex is `kombai@<marketplace>`, where `<marketplace>` is the folder after\n`plugins/cache/` in this skill's own path: `~/.codex/plugins/cache/openai-curated-remote/kombai/…` gives\n`kombai@openai-curated-remote`.\n\nThe prompts to try, each the request a new chat starts with (the same ones as the CLI's starters card):\n\n- Design a standout UI for my website\n- Explore design directions on canvas\n- Redesign this section for my app\n\nTo show them as links, build each in exec as `codex://threads/new?prompt=` followed by\n`encodeURIComponent('[@Kombai](plugin://<id>) ' + prompt)` with Kombai's plugin id, then `(` and `)` as `%28` and\n`%29`. End your reply with **Try one in a new chat:** and the links as a list, each `[@Kombai <prompt>](link)`, so a\nlink reads as what it puts in the new chat's message box, unsent, with Kombai mentioned. Give a link no other title.\n\nFirst look for Kombai's tools in this chat: in exec, `ALL_TOOLS.filter((t) => t.name.startsWith('mcp__kombai'))`.\nThen follow one of the two paths below.\n\n**If `canvas_app` is there**, Kombai's view is set up and this chat has it:\n\n1. Run `npx -y @kombai/cli@0.1.5 whoami`. If the user isn't signed in, sign them in as\n   `npx -y @kombai/cli@0.1.5 skill sign-in` says.\n2. If `starters_card` is there too, call it with `plugin` set to Kombai's plugin id, and end your turn with one\n   line, such as \"Pick one to try.\" Don't list the prompts in text. If it isn't (an older Kombai CLI), show the\n   prompts as links instead.\n\n**If it isn't there**, set Kombai's view up:\n\n1. Run `npx -y @kombai/cli@0.1.5 mcp install codex`. It adds Kombai's canvas view to Codex: Kombai's MCP server, in\n   the user's own Codex config. It answers `added` or `replaced` (set up now) or `already` (set up before).\n2. If it answered with `disabled: true`, Kombai's view is turned off in the user's Codex config (`enabled = false`),\n   so no chat gets it: tell the user the canvas can't be shown until they turn it back on, show no links, and stop.\n   If it answered `notStarting: true`, Kombai's server isn't starting in Codex, so no chat gets the view either: tell\n   the user the canvas can't be shown and why that may be (the answer says), show no links, and stop.\n   If it answered `codexApp: false`, this is Codex in a terminal or an IDE, which shows no canvas view and can't open\n   a link to a new chat: run step 3, tell the user Kombai is ready and that they can ask for a design right here, list\n   the prompts as plain text, not links, and stop.\n3. Run `npx -y @kombai/cli@0.1.5 whoami`. If the user isn't signed in, sign them in as\n   `npx -y @kombai/cli@0.1.5 skill sign-in` says.\n4. Tell the user in one line that Kombai is ready and that a new chat shows its canvas beside the chat. This chat\n   can't, because Codex gives a chat only the MCP servers it had when it started. Then show the prompts as links.\n\n   If the user asked for a design earlier in this chat, follow the install's `next` to move it to a new task instead\n   of showing the links.\n\nIf a command fails before it prints anything:\n\n- **`npx` or `node` not found.** Kombai needs Node.js 20 or later. Tell the user, give them the steps for their OS\n  (macOS: `brew install node`, or the LTS installer from https://nodejs.org; Windows: `winget install\n  OpenJS.NodeJS.LTS`; Linux: nvm, then `nvm install --lts`), and wait; do not install Node yourself.\n- **The network is blocked** (a sandboxed shell). Request approved execution outside the sandbox as above; do not\n  retry inside it.\n\nIf `mcp install codex` answers an error, tell the user what it says in one line.\n"
}

SHA-256 of public snapshot: ad794ec95f9251b0fbfd0ef1dd3dd1fbaeb6e203c65a74b9eda429cd7d71a402