37 resources, one flag syntax

Command reference

Every invocation has the same shape:

node subagent.js <resource> [id] [flags]

resource selects which family API to hit and supplies its default host. [id] is optional — when present, the script requests /api/<endpoint>/<id> instead of the list route. Flags come after.

Resources

`contracts`

API host: subagentcontracts.com · endpoint: /api/contracts

node subagent.js contracts

`tasks`

API host: subagenttasks.com · endpoint: /api/tasks

node subagent.js tasks --query=status:pending

`identities`

API host: subagentidentities.com · endpoint: /api/identities

node subagent.js identities

`citations`

API host: subagentcitations.com · endpoint: /api/citations

node subagent.js citations

`cache`

API host: subagentcache.com · endpoint: /api/cache-snapshots

node subagent.js cache --query=source:manual_dashboard_paste

`rubrics`

API host: subagentrubrics.com · endpoint: /api/rubrics

node subagent.js rubrics rbc_worker_quality

`outcomes`

API host: subagentoutcomes.com · endpoint: /api/outcomes

node subagent.js outcomes

`evaluations`

API host: subagentevaluations.com · endpoint: /api/evaluations

node subagent.js evaluations --query=target_site:subagentidentities.com

`brands`

API host: subagentbrands.com · endpoint: /api/brand-guidelines

node subagent.js brands

`code`

API host: subagentcode.com · endpoint: /api/agent-definitions

node subagent.js code --query=model:claude-fable-5

`prompts`

API host: subagentprompts.com · endpoint: /api/prompt-techniques

node subagent.js prompts --query=category:guardrail

`skills`

API host: subagentskills.com · endpoint: /api/skills

node subagent.js skills --query=plugin:cwc-deploy

`roles`

API host: subagentroles.com · endpoint: /api/roles

node subagent.js roles --query=kind:domain_coworker

`memories`

API host: subagentmemories.com · endpoint: /api/memory-stores

node subagent.js memories

`models`

API host: subagentmodels.com · endpoint: /api/models

node subagent.js models --query=family:fable

`rust`

API host: subagentrust.com · endpoint: /api/serde-types

node subagent.js rust --query=crate:schema

`python`

API host: subagentpython.com · endpoint: /api/pydantic-models

node subagent.js python

`typescript`

API host: subagenttypescript.com · endpoint: /api/zod-schemas

node subagent.js typescript

`permissions`

API host: subagentpermissions.com · endpoint: /api/permission-policies

node subagent.js permissions

`vaults`

API host: subagentvaults.com · endpoint: /api/credential-types

node subagent.js vaults

`sessions`

API host: subagentsessions.com · endpoint: /api/session-statuses

node subagent.js sessions

`tools`

API host: subagenttools.com · endpoint: /api/agent-tools

node subagent.js tools

`hooks`

API host: subagenthooks.com · endpoint: /api/webhook-events

node subagent.js hooks --query=category:vault

`handoffs`

API host: subagenthandoffs.com · endpoint: /api/handoffs

node subagent.js handoffs

`graphql`

API host: subagentgraphql.com · endpoint: /api/graphql-types

node subagent.js graphql

`html`

API host: subagenthtml.com · endpoint: /api/patterns

node subagent.js html

`swift`

API host: subagentswift.com · endpoint: /api/patterns

node subagent.js swift

`engineering`

API host: subagentengineering.com · endpoint: /api/engineering-role-facts

node subagent.js engineering

`legal`

API host: subagentlegal.com · endpoint: /api/legal-facts

node subagent.js legal

`finance`

API host: subagentfinance.com · endpoint: /api/finance-facts

node subagent.js finance

`managers`

API host: subagentmanagers.com · endpoint: /api/managers

node subagent.js managers

`support`

API host: subagentsupport.com · endpoint: /api/support-capabilities

node subagent.js support

`plugins`

API host: subagentplugins.com · endpoint: /api/repo-plugins

node subagent.js plugins

`sdk`

API host: subagentsdk.com · endpoint: /api/sdks

node subagent.js sdk

`servers`

API host: subagentservers.com · endpoint: /api/mcp-servers

node subagent.js servers

`spec`

API host: subagentspec.com · endpoint: /api/criteria

node subagent.js spec

`protocols`

API host: subagentprotocols.com · endpoint: /api/protocols

node subagent.js protocols --query=category:x402

Flags

Flag	Meaning
`--site=host`	Override the default host for the chosen resource — useful for pointing at a staging deploy or a fork.
`--query=key:value,key2:value2`	Comma-separated `key:value` pairs, translated into `?key=value&key2=value2` query-string parameters on the request.
`--data='{"json":"body"}'`	A raw JSON string sent as the request body. Supplying `--data` without an explicit `--method` automatically switches the request to `POST`.
`--method=GET\|POST\|PATCH`	Explicit HTTP method. Defaults to `POST` when `--data` is set, otherwise `GET`.
`--token=SECRET`	Sent as `Authorization: Bearer SECRET` — required by every family site's write endpoints (e.g. `CACHE_WRITE_SECRET`, `IDENTITIES_WRITE_SECRET`, `CITATIONS_WRITE_SECRET`).

Reading the response

The script always tries to parse the response body as JSON and pretty-print it with two-space indentation. If parsing fails (not every family route returns JSON), it falls back to printing the raw response text. A non-2xx HTTP status sets a non-zero exit code, so subagent.js composes cleanly with shell && chains and CI scripts.

Full examples

node subagent.js contracts
node subagent.js contracts ctr_devices_catalog
node subagent.js tasks --query=status:pending
node subagent.js tasks tsk_wire_live_cache_graphql --method=PATCH --data='{"status":"completed"}' --token=$TASKS_WRITE_SECRET
node subagent.js cache --query=source:manual_dashboard_paste
node subagent.js evaluations --query=target_site:subagentidentities.com
node subagent.js rubrics rbc_worker_quality
node subagent.js identities --site=staging.subagentidentities.com

Download the script at /subagent.js, or read the install page for the one-liner.

subagentcli

Command reference

Resources

contracts

tasks

identities

citations

cache

rubrics

outcomes

evaluations

brands

code

prompts

skills

roles

memories

models

rust

python

typescript

permissions

vaults

sessions

tools

hooks

handoffs

graphql

html

swift

engineering

legal

finance

managers

support

plugins

sdk

servers

spec

protocols