using-ao

using-ao is a skill for Claude Code, Codex from Untrivial-ai/agent-orchestrator. It costs 71 tokens per session (1,161 once invoked), scanned A, original, Apache-2.0.

A reference guide for the AO command-line tool, which manages other coding agents and their workspaces. It explains commands for workers, sessions, projects, previews, messaging, and reviews.

In plain words
What is it for?
Use it when starting worker agents, managing agent sessions, configuring projects, opening previews, sending instructions, or submitting reviews.
Why use it?
It gives developers one place to check how AO commands work instead of relying on memory or trial and error.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it when starting worker agents, managing agent sessions, configuring projects, opening previews, sending instructions, or submitting reviews.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/untrivial-ai/agent-orchestrator/using-ao
About the project

Agent Orchestrator is a local desktop workspace for running and supervising multiple coding agents, giving each task its own session, workspace, branch, and feedback loop. It is for developers coordinating agent fleets across repositories, pull requests, CI runs, reviews, and merges. The catalogue entries are commands, skills, and instructions for working with this orchestrator.

Untrivial-ai/agent-orchestrator · 13,060 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Untrivial-ai/agent-orchestrator --skill using-ao
Clone the repo
git clone --depth 1 https://github.com/Untrivial-ai/agent-orchestrator

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for using-ao

README.md
[![agentmods](https://agentmods.dev/badge/skills/untrivial-ai/agent-orchestrator/using-ao/github.svg)](https://agentmods.dev/skills/untrivial-ai/agent-orchestrator/using-ao)
Your own site
<a href="https://agentmods.dev/skills/untrivial-ai/agent-orchestrator/using-ao"><img src="https://agentmods.dev/badge/skills/untrivial-ai/agent-orchestrator/using-ao/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for using-ao

Your own site · 80×15
<a href="https://agentmods.dev/skills/untrivial-ai/agent-orchestrator/using-ao"><img src="https://agentmods.dev/badge/skills/untrivial-ai/agent-orchestrator/using-ao.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 71 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,161 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00071 $0.01161
Opus 5.5 $0.00028 $0.00464
Sonnet 5.5 $0.00014 $0.00232
Haiku 4.5 $0.00007 $0.00116

Measured 11d ago against content hash c8b02badbcda, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

using-ao scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

backend/internal/skillassets/using-ao/SKILL.md · 55 lines

How it starts

The opening of the file, as written. The whole thing — 55 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AO CLI Catalog

ao is a thin CLI over the local AO daemon. Every command is ao <command> --help for the authoritative flag list.

Command What it does When to use Details
spawn Spawn a project worker, orchestrator, or projectless standalone worker Starting a new task or issue commands/spawn.md
session Manage agent sessions (list, kill, rename, restore, etc.) Inspecting or controlling running/terminated sessions commands/session.md
agent Inspect installed harnesses and launch readiness Choosing or diagnosing an agent harness ao agent ls --refresh
pr Merge a PR or resolve its review threads Completing a reviewed change ao pr merge / ao pr resolve-comments
project Register, inspect, configure, or remove projects Setting up or managing repos AO knows about commands/project.md
automation Manage durable recurring session automations Creating, editing, disabling, deleting, and inspecting scheduled runs commands/automation.md
cue Create or list reusable project Cues Saving a repetitive command or agent task at the user's request commands/cue.md
orchestrator List orchestrator sessions Viewing which sessions are orchestrators commands/orchestrator.md
review List, submit, cancel, or trigger a reviewer pass for a worker's PR Managing a code review loop commands/review.md
send Send a message to a running agent session Correcting or directing a live agent commands/send.md
report Persist a meaningful worker report Checkpoints, blockers, decisions, outputs, and completion commands/report.md
preview Start a session-owned app or open an exact URL/file Running and showing the worker's relevant app, Markdown, HTML, PDF, or image commands/preview.md
browser Inspect and control the session's shared live browser Verifying a web app through snapshots, interactions, waits, screenshots, console, and errors commands/browser.md
start Fetch (if needed) and open the AO desktop app Launching the app commands/start.md
stop Stop the AO daemon Shutting down AO commands/stop.md
status Show daemon status Verifying the daemon is up and healthy commands/status.md
doctor Run local health checks Diagnosing AO setup problems commands/doctor.md
import Import projects from a legacy AO install Migrating from the old flat-file store commands/import.md
version Print version information Checking installed version -
completion Generate shell completion scripts Setting up tab completion -

Read the full file on GitHub · 55 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago Changed · +2 lines c8b02badbcda
  2. 14d ago Changed · +4 lines c511e18be075
  3. 15d ago Changed · +2 lines · +9 tokens per session b7bfd984c828
  4. 18d ago Changed · +1 lines 17dc465647b3
  5. 22d ago Changed · +1 lines 51cb0e436810
  6. 1mo ago Changed ac2a58b5161b
  7. 1mo ago First seen · 45 lines · 62 tokens per session scan A 3aa01b1ecb5f

Subscribe to this mod's changes

using-ao is a skill published in the GitHub repository Untrivial-ai/agent-orchestrator (13,060 stars, last pushed 5d ago), licensed Apache-2.0. It adds 71 tokens to every session and 1,161 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.