@kongyo2/apts

Agent-Primary TypeScript Starters — a CLI that lets coding agents search and retrieve the agent-primary-ts-starters skill guides on demand.

apts wraps four agent-friendly TypeScript starters (tsconfig, Prettier, Oxlint, Zod) behind a semantic-search interface. Use it as a one-shot CLI so coding agents pull the right guidance into context automatically.

Quickstart

# Search for relevant skills
npx @kongyo2/apts@latest search "set up strict tsconfig for an LLM agent loop"

# Retrieve a guide by ID
npx @kongyo2/apts@latest retrieve "ts-tsconfig-modern-strict-starter"

# List every available skill
npx @kongyo2/apts@latest list

CLI reference

apts search <query> [flags]

Semantic search over the skill catalog. Returns a JSON array sorted by cosine similarity.

| Flag | Type | Default | Description | | --- | --- | --- | --- | | --limit <N> | int > 0 | 5 | Maximum number of results. | | --threshold <0.0-1.0> | float | 0.0 | Minimum similarity to include. | | --format <fmt> | json | text | json | text emits one-line human-readable rows. |

# Take only the single best match
npx @kongyo2/apts@latest search "lint TypeScript without stylistic noise" --limit 1

# Drop weak matches
npx @kongyo2/apts@latest search "runtime validation" --threshold 0.4

# Human-readable output for eyeballing
npx @kongyo2/apts@latest search "format diff-friendly" --format text

apts retrieve <ids> [flags]

Pull one or more SKILL.md files by ID. Comma-separated IDs are supported.

| Flag | Type | Default | Description | | --- | --- | --- | --- | | --format <fmt> | markdown | json | markdown | json returns [{ id, frontmatter, content, … }]. |

# Default: raw markdown, ready to inline into agent context
npx @kongyo2/apts@latest retrieve ts-npm-prettier-starter

# Structured for programmatic consumers
npx @kongyo2/apts@latest retrieve ts-npm-prettier-starter,ts-npm-oxlint-starter --format json

apts list

Print the full catalog as JSON: { id, category, description, tokenCount }.

License

MIT. Skill content under skills/ is mirrored from agent-primary-ts-starters.