Features

v0.1.0 (2026-05-10)

Universals (afi-template)

agtag --version
agtag learn — self-teaching prompt for agent consumers; supports --json.
agtag explain <path> — markdown documentation for any noun/verb path; supports --json.
Structured errors: every failure emits {code, message, remediation} (text or JSON).
Exit-code policy: 0 success, 1 user-input error, 2 environment/setup error.

`issue` noun group

agtag issue post --repo OWNER/REPO --title T (--body B | --body-file F) — open a new issue.
agtag issue fetch (--repo … --number … | <url>) — read an issue body and its comments.
agtag issue reply --repo OWNER/REPO --number N (--body B | --body-file F) — comment on an issue.

All write verbs:

Auto-sign with - <nick> (Claude). <nick> resolves from the local culture.yaml (agents[0].suffix), falling back to the repo basename. --as NICK overrides.
Are idempotent: re-signing a body that already ends with the signature line is a no-op.

fetch is read-only and emits no signature.

Roadmap

v0.2 — `agtag message` (mesh transport)

Migrate the existing culture agent message <channel> <body> CLI into agtag message --channel <channel> --body <body>, so message-by-CLI and issue-by-CLI share one binary. Mesh messages remain unsigned (the IRC nick already identifies the speaker).

Out of scope (separate repo)

PR review-thread tooling — anything currently in cicd/scripts/pr-reply.sh and cicd/scripts/pr-batch.sh — belongs to the planned agex-cli repo (agent-experience / dev-experience-for- agents). agtag’s cicd skill is left untouched.