Project adoption

Use frigg adopt to keep project agent instructions and MCP configuration aligned with the installed Frigg workflow. Run it from the project repository or pass --workspace-root.

Preview and apply changes

Select targets explicitly for a predictable first setup:

frigg adopt --target agents-md --target mcp-project --dry-run
frigg adopt --target agents-md --target mcp-project

The managed MCP entry uses loopback HTTP and expects frigg serve at the selected host and port.

If you omit targets, Frigg detects existing client markers. When none exist, it defaults to agents-md and claude-md.

Targets

Target	Managed path
`agents-md`	`AGENTS.md`
`claude-md`	`CLAUDE.md`
`copilot`	`.github/copilot-instructions.md`
`cursor`	`.cursor/rules/frigg.mdc`
`mcp-project`	`.mcp.json`
`mcp-cursor`	`.cursor/mcp.json`
`hook`	`.claude/settings.json`

--all selects every non-hook target. Add --target hook explicitly when you also want the soft Claude PreToolUse hook.

Choose the managed instruction policy

The default lightweight policy installs short Frigg-first rules plus a pointer to the production frigg-first-code-search skill:

frigg adopt --target agents-md --policy lightweight

Use expanded when the repository should carry a compact routing policy without depending on the skill being loaded:

frigg adopt --target agents-md --policy expanded

Copy the Frigg-first skill

--skill-provider is repeatable and additive: Frigg still processes the selected adoption targets, then plans a skill copy for each provider.

frigg adopt \
  --target agents-md \
  --skill-provider claude \
  --skill-provider codex \
  --dry-run

Provider	First existing skills directory used
`claude`	`~/.claude/skills`, then project `.claude/skills`
`codex`	`~/.codex/skills`
`cursor`	Project `.cursor/skills`, then `~/.cursor/skills`
`copilot`	Project `.github/skills`, then `~/.copilot/skills`

Frigg never creates a missing parent skills directory. The source must contain SKILL.md and resolves from skills/frigg-first-code-search under the adopted workspace unless FRIGG_SKILL_SOURCE points to another skill directory or its SKILL.md.

Run skill installation from the Frigg checkout, use a repository that contains the skill tree, or set the override:

FRIGG_SKILL_SOURCE=/absolute/path/to/frigg-first-code-search \
frigg adopt --target agents-md --skill-provider codex

Check drift in CI

--check performs no writes and exits unsuccessfully when a selected target or skill would change:

frigg adopt --target agents-md --target mcp-project --check

Re-run adoption after upgrading Frigg or its bundled skill. Reload the client and confirm its live MCP tool list before relying on newly added tools.

Replace or remove managed entries

Frigg preserves unrelated file content. A diverged Frigg MCP entry is skipped unless you pass --force:

frigg adopt --target mcp-project --force

Remove managed documentation and MCP entries with matching targets:

frigg adopt --target agents-md --target mcp-project --uninstall

Skill removal is also provider-specific. Include the same provider used for installation:

frigg adopt --target agents-md --skill-provider codex --uninstall

Preview destructive changes with --dry-run first.

Source Anchors

../frigg/README.md
../frigg/crates/cli/src/cli_args.rs
../frigg/crates/cli/src/agent_directive.rs
../frigg/crates/cli/src/cli_runtime/commands/adopt/mod.rs
../frigg/crates/cli/src/cli_runtime/commands/adopt/targets.rs
../frigg/crates/cli/src/cli_runtime/commands/adopt/json_merge.rs
../frigg/crates/cli/src/cli_runtime/commands/adopt/skill_install.rs