@agents-inc/cli

Agents Inc

An agent composition framework that builds stacks and compiles specialized subagents for Claude Code.

npx @agents-inc/cli init

What this does

Claude Code doesn't know your stack. It doesn't know your patterns, your conventions, or the specific way you use your tools. So you end up repeating the same instructions or maintaining freeform markdown skills that fail silently when something's wrong.

Agents Inc fixes this with structured skills: focused knowledge modules for specific technologies. Each skill covers patterns, conventions, anti-patterns, edge cases, and real code examples. Skills get compiled into specialized subagents (a web developer, a reviewer, a tester, a PM) that actually know what they're doing.

The whole thing is opt-in and works alongside your existing Claude Code setup. It uses smart defaults, but there are progressive levels of customization: edit the config, swap skills, choose which to preload and which to load dynamically, eject templates, eject agent partials, or eject entire skills.

Under the hood, the CLI is written in strict TypeScript with Zod for runtime validation and JSON Schema generation. Skills and agents are validated against these schemas, so misconfigurations surface immediately. Agent compilation uses Liquid templates, so the output format is fully customizable without touching CLI internals.

Getting started

# Run the wizard
npx @agents-inc/cli init

# Or install globally
npm install -g @agents-inc/cli

Requires Node 18+ and Claude Code.

The wizard walks you through the full setup:

1. Pick a stack or start from scratch

Stacks bundle skills together with pre-configured agents. Instead of picking skills individually, grab a stack that matches your setup:

• nextjs-fullstack: Next.js + React + Hono + Drizzle + PostHog + Zustand + React Query
• angular-stack: Angular 19 + Signals + NgRx SignalStore + Hono + Drizzle
• vue-stack: Vue 3 Composition API + Pinia + Hono + Drizzle
• nuxt-stack: Nuxt + Vue 3 full-stack + Pinia + Hono + Drizzle
• remix-stack: Remix + React + Hono + Drizzle
• solidjs-stack: SolidJS + Hono + Drizzle
• react-native-stack: React Native + Expo + Zustand + React Query
• meta-stack: Agents for creating agents, skills, docs, and extracting patterns

Or select "Start from scratch" to browse domains and pick skills one by one.

2. Customize skills

After picking a stack, you can add or remove individual skills. 87+ skills are available across these categories:

Web
React Vue Angular SolidJS Next.js Remix Nuxt SCSS Modules CVA Zustand Pinia NgRx SignalStore Jotai React Query SWR tRPC GraphQL React Hook Form Zod shadcn/ui Radix UI TanStack Table Vitest Playwright Cypress MSW Framer Motion Storybook Accessibility

API
Hono Express Fastify Drizzle Prisma Better Auth PostHog Resend Axiom + Pino + Sentry GitHub Actions

Mobile
React Native Expo

CLI
Commander oclif + Ink

Infra
Turborepo Tooling Env config

Meta
Code reviewing Research methodology Investigation requirements Anti-over-engineering Context management

Skills live in the Agents Inc marketplace. Each one is a structured package with metadata, versioning, and compatibility declarations. Everything is validated against schemas, so if a skill name doesn't match or a config is malformed, you get an actual error instead of silent failure.

3. Configure subagents

Each stack includes agents like web-developer, api-developer, web-reviewer, web-tester, web-researcher, pattern-scout, and documentor: roles that use the right skills for the job.

Both modes (stack or from scratch) compile agents and generate a config at .claude-src/config.yaml. Use agentsinc edit to change your setup at any time.

Commands

Command	Description
init	Interactive setup: pick skills, configure agents
edit	Modify your skill selection
compile	Recompile agents after changes
update	Pull latest skills from source
search	Search skills across sources (interactive or static query)
eject	Export skills or agent partials for customization
new skill	Scaffold a custom skill
new agent	Scaffold a custom agent
import skill	Import a skill from an external GitHub repository
doctor	Diagnose setup issues
uninstall	Remove Agents Inc from your project

Every command supports --dry-run and --source flags. Run agentsinc --help for the full command list including config, version, build, diff, outdated, validate, info, and list.

Importing third-party skills

Import skills from any GitHub repository into your local setup:

# List available skills from a repository
agentsinc import skill github:your-org/skills --list

# Import a specific skill
agentsinc import skill github:your-org/skills --skill react-best-practices

# Import all skills from a repository
agentsinc import skill github:your-org/skills --all

Imported skills are copied to .claude/skills/ and tracked with metadata for future updates.

Customization

Everything is configured through .claude-src/config.yaml with schema validation. There are progressive levels of customization depending on how deep you want to go:

Edit the config directly to change skill-to-agent mappings:

web-developer:
  web-framework:
    id: web-framework-react
    preloaded: true
  web-styling: web-styling-tailwind-v3

Eject for deeper control:

# Eject agent partials (intro, workflow, critical requirements, etc.)
npx @agents-inc/cli eject agent-partials

# Eject the Liquid templates that control how agents are compiled
npx @agents-inc/cli eject agent-partials --templates

# Eject skills for local editing
npx @agents-inc/cli eject skills

Create custom skills when you need something that doesn't exist:

npx @agents-inc/cli new skill my-custom-skill

Architecture

The CLI uses oclif for commands, Ink (React) for the terminal UI, and Zustand for wizard state. The codebase is organized into domain-driven library modules with barrel exports.

See docs/reference/architecture.md for the full reference.

Links

• Agents Inc Skills: the marketplace

License

MIT