cabinets

CLI to install cabinets — plug-and-play AI teams made of agents, jobs, and data.

Browse cabinets at cabinets.sh

Registry source & docs: github.com/hilash/cabinets

Quick start

npx cabinets add agency

That's it — a fully-structured AI team on disk.

What is a cabinet?

A cabinet is a directory that contains everything an AI-powered team needs to operate:

| What | Where | Purpose | |---|---|---| | Agents | .agents/<slug>/persona.md | Persistent AI team members with roles, schedules, and focus areas | | Jobs | .jobs/<name>.yaml | Scheduled automations owned by agents (cron-based) | | Data | *.md, *.csv in the tree | Knowledge base — visible, version-controlled files |

my-cabinet/
  .cabinet              # identity & metadata (YAML)
  .agents/              # AI team members
    ceo/persona.md
    cto/persona.md
  .jobs/                # scheduled automations
    weekly-brief.yaml
  .cabinet-state/       # runtime state
  index.md              # entry point

Cabinets nest — a root cabinet can contain child cabinets, each a self-contained team with their own agents and jobs. A company is modeled as a tree of cabinets.

Install from the registry

Browse all available cabinets at cabinets.sh or from the terminal:

npx cabinets browse

  agency           Digital agency managing multiple client engagements
  career-ops       AI-powered job search command center
  content-creator  Solo content creator operation
  ecommerce        D2C e-commerce brand
  job-hunt-hq      Job hunt cabinet with strategist, coach, and scout
  real-estate      Real estate brokerage with listings and marketing
  saas-startup     B2B SaaS with PLG, engineering, and customer success
  text-your-mom    B2C app company (nested cabinet demo)

Install any cabinet by name:

npx cabinets add agency
npx cabinets add career-ops
npx cabinets add text-your-mom

Install from any source

# From any GitHub repo
npx cabinets add user/repo/my-cabinet

# From a GitHub URL
npx cabinets add https://github.com/hilash/cabinets/tree/main/agency

# From a local path
npx cabinets add ./my-cabinet

A single name like agency resolves to hilash/cabinets/agency.

Create a cabinet from scratch

npx create-cabinet

Scaffolds a blank cabinet with the required structure. See create-cabinet on npm.

Commands

| Command | Description | |---|---| | cabinets add <source> | Install a cabinet from the registry, GitHub, or a local path | | cabinets browse | Browse all cabinets in the registry | | cabinets list | List cabinets installed in the current directory | | cabinets info <name> | Inspect a cabinet before installing |

Options for add

| Flag | Description | |---|---| | --as <name> | Rename the cabinet directory on install | | --dir <path> | Install into a different parent directory | | --ref <ref> | Use a specific branch, tag, or commit | | --dry-run | Preview without writing files | | --force | Overwrite existing directory without prompting | | -y, --yes | Skip interactive prompts |

npx cabinets add agency --as my-agency
npx cabinets add saas-startup --dry-run
npx cabinets add agency --dir ./projects

Private repos

Set GH_TOKEN or GITHUB_TOKEN to install from private repositories:

GH_TOKEN=ghp_xxx npx cabinets add myorg/private-cabinets/internal

Links

• cabinets.sh — browse the registry
• github.com/hilash/cabinets — registry source & cabinet file format docs
• create-cabinet — scaffold a blank cabinet

License

MIT