AI & Agentslow risk

metagit-aos

Compose ACL, task graph, scheduler, merge, and related coordination subsystems via metagit aos|coord status|doctor|next. Use when an operator or orchestrator needs one snapshot of coordination health or the next work envelope without launching models.

metagit-ai/metagit-cli·.agents/skills/metagit-aos/SKILL.md

85/ 100Quality

↓

Install this skill

Choose your coding agent and copy a project or personal installation command.

Pinned to the indexed commit

Project installation.agents/skills/metagit-aos

npx skills add https://github.com/metagit-ai/metagit-cli/tree/482dfb3b7a407ca5e541657a6fcc9af619818243/.agents/skills/metagit-aos -a codex -y

Personal installation~/.agents/skills/metagit-aos

npx skills add https://github.com/metagit-ai/metagit-cli/tree/482dfb3b7a407ca5e541657a6fcc9af619818243/.agents/skills/metagit-aos -a codex -g -y

Manual folder.agents/skills/metagit-aosOfficial docs ↗

Project installation.claude/skills/metagit-aos

npx skills add https://github.com/metagit-ai/metagit-cli/tree/482dfb3b7a407ca5e541657a6fcc9af619818243/.agents/skills/metagit-aos -a claude-code -y

Personal installation~/.claude/skills/metagit-aos

npx skills add https://github.com/metagit-ai/metagit-cli/tree/482dfb3b7a407ca5e541657a6fcc9af619818243/.agents/skills/metagit-aos -a claude-code -g -y

Manual folder.claude/skills/metagit-aosOfficial docs ↗

Project installation.agents/skills/metagit-aos

npx skills add https://github.com/metagit-ai/metagit-cli/tree/482dfb3b7a407ca5e541657a6fcc9af619818243/.agents/skills/metagit-aos -a github-copilot -y

Personal installation~/.copilot/skills/metagit-aos

npx skills add https://github.com/metagit-ai/metagit-cli/tree/482dfb3b7a407ca5e541657a6fcc9af619818243/.agents/skills/metagit-aos -a github-copilot -g -y

Manual folder.agents/skills/metagit-aosOfficial docs ↗

Project installation.agents/skills/metagit-aos

npx skills add https://github.com/metagit-ai/metagit-cli/tree/482dfb3b7a407ca5e541657a6fcc9af619818243/.agents/skills/metagit-aos -a cursor -y

Personal installation~/.cursor/skills/metagit-aos

npx skills add https://github.com/metagit-ai/metagit-cli/tree/482dfb3b7a407ca5e541657a6fcc9af619818243/.agents/skills/metagit-aos -a cursor -g -y

Manual folder.agents/skills/metagit-aosOfficial docs ↗

Project installation.agents/skills/metagit-aos

npx skills add https://github.com/metagit-ai/metagit-cli/tree/482dfb3b7a407ca5e541657a6fcc9af619818243/.agents/skills/metagit-aos -a gemini-cli -y

Personal installation~/.gemini/skills/metagit-aos

npx skills add https://github.com/metagit-ai/metagit-cli/tree/482dfb3b7a407ca5e541657a6fcc9af619818243/.agents/skills/metagit-aos -a gemini-cli -g -y

Native Gemini CLIgemini skills install https://github.com/metagit-ai/metagit-cli.git --scope workspace --path .agents/skills/metagit-aos

Manual folder.agents/skills/metagit-aosOfficial docs ↗

⚠ Installation uses the open-source skills CLI. Inspect the source and permissions before running the command.

Skill instructions

View source on GitHub ↗

# Metagit Agent Operating System (AOS)

<!-- modality:aos_status -->

Use when you need a **composed** view of coordination state, or a preview of
what should run next across ACL + task graph + optional 0009–0012.

Full reference: [docs/reference/aos.md](../../../../docs/reference/aos.md)

## Control loop

```bash
export METAGIT_AGENT_MODE=true

metagit aos status --json
metagit aos doctor --json
metagit aos next --json                 # preview (no schedule record)
metagit aos next --commit --json        # record schedule decision
# then compile / ACL / work / complete / merge enqueue as separate steps
metagit context compile --project P --repo R --task-id NODE --json
metagit aos next --apply-hints --agent-id agent-1 --json   # ACL APIs only
```

Alias: `metagit coord …` is identical to `metagit aos …`.

## Rules

- Doctor `--fix` requires `--yes` and only runs lease expire-on-list + worktree gc.
- `next --apply-hints` never launches models and never runs compile.
- Prefer `aos next` preview before `--commit` when exploring.

## Related

- ACL primitives: skill `metagit-agent-coordination`
- Scheduler alone: `metagit schedule next`