Skip to main content
ZR
Toggle navigation
Work

Supporting system

Agent Starter

Agent setup CLI for consistent Claude Code, Codex, and Cursor project configuration.

Tier
Supporting system
Pillar
OSS infrastructure
Visibility
Public
Status
functional
Date
Nov 2024

Case boundary

Project-local agent setup tool that converts one agent.json file into native Codex, Claude Code, and Cursor configuration without storing credentials.

Claim boundary

Configuration generator, not an orchestration framework or agent runtime.

Agent Starter installs project-local configuration for Codex, Claude Code, and Cursor.

It is not an orchestration framework. The core abstraction is agent.json: one declarative config that syncs into the native files each tool already understands.

npx create-agent-starter@3.0.0 --agent all

System

  • agent.json defines agents, skills, MCP profiles, rules, and project conventions
  • Native outputs target .claude/, .codex/, and .cursor/
  • Managed blocks preserve manual edits outside generated sections
  • Credentials are referenced through environment interpolation, not written as literals

Runtime

  • npx create-agent-starter bootstraps a project
  • agent-starter sync refreshes native config after edits
  • Profiles cover minimal, web, SaaS, and design-heavy projects
  • Stack detection reads local package metadata before enabling defaults

Proof

  • One config emits Claude Code settings, Codex TOML, and Cursor MCP/rule files
  • Re-syncing is idempotent across supported agents
  • MCP credentials stay outside repository files
  • Backwards-compatible package alias is maintained for older installs