@fnmoa/cli — moa

A terminal client for the Moa server — drives tasks and workflows over the same HTTP API the dashboard uses.

Install

npm i -g @fnmoa/cli

Setup

Run moa login (it also starts automatically on first run) — an interactive onboarding that sets your server URL and API key:

moa login

It defaults to https://api.fnmoa.com; grab your API key from the Moa dashboard. Prefer non-interactive? moa config set url <url> and moa config set key <key>.

Then use it:

moa status
moa wf pending
moa wf solve owner/repo 42 --watch

Commands

moa login                          connect: set server URL + API key (interactive)
moa status                         overview snapshot
moa setup                          connector (Claude/GitHub) status
moa tasks | task <id>              list / show tasks
moa run "<prompt>" [--dir D] [--autonomous] [--watch]
moa cancel <taskId>

moa wf                             list runs
moa wf pending                     available issues/PRs
moa wf get <id> [--watch]          one run + step timeline
moa wf cancel <id>
moa wf solve   <repo> <issue#> [--base B] [--watch]
moa wf triage  <repo> <issue#> [--watch]
moa wf review  <repo> <pr#>    [--watch]
moa wf address <repo> <pr#>    [--watch]
moa wf fix-ci  <repo> <pr#>    [--watch]
moa wf merge   <repo> <pr#>    [--watch]

moa oracle list                    list oracle domains
moa oracle consult <domain> "<question>" [--watch]
moa oracle history

moa gh pulls | issues

moa config                         show effective URL/key + file path
moa config set url <url>           persist the API URL (~/.moa/cli.json)
moa config set key <key>           persist an API key
moa config clear

moa skills                         list the bundled Moa skills
moa skills show <name>             print a skill's SKILL.md
moa skills install [name] [--tool claude|cursor|codex|all] [--dir D] [--force]

moa help --json emits the full command catalog (every command + sub-action, with usage and documented args) as JSON, so an agent can discover capabilities programmatically. moa help (text) is rendered from the same registry, so docs never drift.

Skills

The CLI bundles ready-to-use agent skills (setup, ship-issue, review-pr, triage-audit, run-task, oracle, profiles). Install them into your coding agent — each tool gets the right format:

moa skills                              # list them
moa skills install --tool claude        # → ~/.claude/skills/<name>/SKILL.md
moa skills install --tool cursor        # → ./.cursor/rules/<name>.mdc
moa skills install --tool codex         # → ~/.codex/prompts/<name>.md  (use as /<name>)
moa skills install --tool all           # all three
moa skills install moa-setup --tool cursor   # just one skill

Config

URL/key resolve env var → ~/.moa/cli.json (moa config) → default, so you can persist them once instead of exporting env vars.

| Env | Default | | | --- | --- | --- | | MOA_API_URL | https://api.fnmoa.com | Server base URL | | MOA_API_KEY | — | API key | | MOA_CONFIG | ~/.moa/cli.json | Config file path | | NO_COLOR | — | Disable ANSI colors |