ai-devkit-setup

1# AI DevKit Setup
2 
3Use this skill when a user wants to onboard AI DevKit, prepare a harness, repair local AI DevKit integration, or check whether setup is needed.
4 
5Keep the workflow status-driven and simple. Prefer the installed `ai-devkit` binary; if it is unavailable, use `npx ai-devkit@latest`.
6 
7## Execution Notes
8 
9- Under filesystem sandboxing, run `ai-devkit status --json` and any `ai-devkit setup` command outside the sandbox. These commands inspect and modify host-level agent configuration; sandboxed runs can produce false failures or block setup writes, especially for integrations that execute harness commands and access paths like `~/.pi/agent`.
10 
11## Workflow
12 
131. Run readiness first:
14 
15   ```bash
16   ai-devkit status --json
17   ```
18 
192. Identify failed or warning checks that setup can fix. Setup covers local integrations like hooks, built-in skills, and session tracking for `codex`, `pi`, and `claude`; it does not fix auth, missing package managers, or host tools requiring user installation.
20 
213. Run the narrowest setup command, for example:
22 
23   ```bash
24   ai-devkit setup --agent codex,pi,claude
25   ```
26 
27   If the user asked for broad onboarding and several supported harnesses need setup, `ai-devkit setup` is acceptable.
28 
294. Re-run `ai-devkit status --json` and report what changed plus any remaining manual actions.
30 
31## Boundaries
32 
33- Do not run setup before checking status unless the user explicitly asks to force setup.
34…