Safe setup · project first · provider native
AIWG installation is an agent-guided flow with explicit inspection, approval, and verification gates. Paste one prompt into the coding agent that already has your project open.
Checks the project, explains changes, and asks for approval.
Writes provider-native files, then proves AIWG is engaged.
Recommended path
The URL identifies a versioned setup flow. Your agent reads the YAML instructions, inspects your environment, explains the proposed changes, asks for approval, and then performs only the approved work.
Install or repair AIWG for this project by following https://aiwg.io/setup.aiwg.yaml Explain the plan before changing anything, preserve my existing work, and ask me only for choices you cannot safely determine.
Want to understand the instructions first? Review the complete setup manifest with line-by-line source and SHA-256 verification →
Optional runtime
Use this when agents need durable sessions, human approvals, containers or virtual machines, controlled networking, and an audit trail on infrastructure you operate.
Install or repair AIWG Cockpit and Agentic Sandbox by following https://aiwg.io/agentic-sandbox/setup.aiwg.yaml Install the required prerequisites, explain the plan before changing anything, preserve my existing work, and ask me about the isolation, network, storage, and access choices you cannot safely determine.
Inspect the secure-runtime instructions before using them. Review the Agentic Sandbox setup YAML with source and SHA-256 verification →
Agent bootstrap
AIWG installs no daemon and modifies no operating-system components. It deploys a compact set of always-visible core skills and bootstrap instructions that orient your coding agent. The remaining capability library stays discoverable on demand.
Bootstrap layer
Quick references, discovery guidance, status, doctor, refresh, regenerate, and other self-maintenance skills stay in the provider’s normal skill surface.
Standard tier
Hundreds of specialized capabilities remain under the AIWG installation. The agent
finds them with aiwg discover and reads the match with
aiwg show.
Project memory
The .aiwg/ tree holds project artifacts and decisions so later sessions
can continue from reviewable files instead of private chat memory.
Session bootstrap
The generated bootstrap stays intentionally short. Each layer points to the next, giving the agent enough orientation to retrieve deeper instructions without flooding its initial context.
Manual path
Use Node.js 20 or newer. Project scope is the recommended default because it keeps one project’s agent setup from appearing in unrelated sessions.
npm install -g aiwg
cd /path/to/your/project
aiwg use all --provider <provider>
Definition of done
Setup finishes only when the executable, project root, provider adapter, context files, indices, and capability discovery all agree.