Installing kits for multiple runtimes, per project or global: the real certification table, no rose-tinted glasses

Article 4/20 in the AgentKit v3 onboarding series. About a 9 minute read.

"Does AgentKit run on Cursor?" The honest answer: it installs, but it is not certified yet. This article gives you the table I use internally to decide how "mature" each runtime is, then shows how to install for each case.

1/ The v3.0.0 runtime certification table

Each runtime is trial-run on 3 environments: macOS arm64, Windows 11, Linux (WSL). Results:

How to read this table?

• If you use Claude Code or DeepSeek Harness: relax, this is the main road.

• Codex: works well on macOS and Linux. On Windows it runs, but not everything is green.

• Cursor, Antigravity: installable to try out, but do not take them to important work right now.

One thing I have to admit: the agentkit.best FAQ page currently lists Antigravity as an "available" runtime, while the certification table says spike and ak update does not accept agy as a target. I logged it in the gap report so it gets fixed to match.

2/ Project or global?

My advice: start with project. Your team clones the repo and has every skill, regardless of what anyone installed on their own machine.

3/ Installing for one runtime ✅

By default ak kit init installs for Claude Code, in the current project:

cd ~/projects/your-project
ak kit init engineer --yes

For Claude Code, project-native mode merges the content into ./.claude and stores lifecycle metadata in ./.agentkit.

To install globally:

ak kit init engineer --global --yes

4/ Installing for several runtimes at once ✅

--target takes a comma-separated list of IDs:

ak kit init engineer --target claude-code,codex --yes

Add the marketing kit to the same project:

ak kit init marketing --target claude-code,codex --yes

Updates then follow per runtime too:

ak update --target codex --yes

According to the ak update help in 3.0.0, the supported project targets are: claude-code, codex, cursor, dsh, grok, omp, pi. Global is the same minus pi.

5/ Installing only a few skills ✅

The Engineer kit has around a hundred skills. If you do not need them all:

ak kit init engineer --skills ak-plan,ak-cook,ak-debug,ak-ship --yes

Or install everything except a few:

ak kit init engineer --exclude-skills ak-motion-video,ak-filmmaking --yes

Or pick with an interactive menu:

ak kit init engineer --select-skills

6/ Situations you will run into

"I edited a skill file, will the update overwrite it?"

It does not overwrite silently. ak records the hash of every file it installs. A file you edited is detected as drift, and the command stops with exit 6. To overwrite you must pass --force, and it still takes a snapshot before writing.

"I want to reset a runtime cleanly back to exactly the kit content"

ak kit init engineer --fresh --target codex

--fresh shows a preview, asks for confirmation, takes a verified snapshot, and only then cleans up. In a script you need --yes, and if the plan lists risks you must also pass the exact --accept-risks token it prints. --yes alone never accepts risks on your behalf.

"Another agent is running an update"

Exit 4: another AgentKit operation is holding the kit lifecycle lock. Wait a moment and run again. Two updates can never trample each other.

"Does Codex read the project rules?"

Codex project rules are written to <project>/.codex/AGENTS.md. According to the certification table, this file is kept but not yet activated by Codex. Put important rules in the repo's root AGENTS.md. Also, the privacy guard on Codex does not yet cover MCP and local read tools (see article 7).

"Can I use the Claude Code plugin instead of copying files?"

ak kit init engineer --switch-to-plugin

This flag picks the Claude Code plugin distribution mode at the scope you choose.

Exit codes worth remembering

Next article: Managing skills and SkillX →

Sources

• v3.0.0 runtime certification matrix in the agentkit repo (tag v3.0.0)

• ak kit init --help, ak update --help (ak 3.0.0): target list, flags --target, --global, --skills, --exclude-skills, --fresh, --accept-risks, exit code table

• FAQ on https://agentkit.best (checked 02/11/2026): the "available" and "preview" runtime lists

• GitHub release v3.0.0, per-runtime kit package asset list: https://github.com/bestagentkits/agentkit/releases/tag/v3.0.0