Documentation

Quick Start

npx @acmeacmeio/setup-sh

That's it. One command bootstraps your entire AI-powered development workspace.

What It Does

setup-sh transforms any directory into a standardized multi-agent workspace. It:

Detects your platform (macOS, Linux, Windows)
Installs missing tools (gh, Node.js, pnpm, Python, uv, browser-use)
Scaffolds agent configurations for your chosen AI coding assistant
Installs external skills to extend your agent's capabilities

Supported Agents

Agent	Config Location	Instructions File
Claude Code (Anthropic)	.claude/	CLAUDE.md
Codex (OpenAI)	.codex/	AGENTS.md
Cursor IDE	.cursor/	CLAUDE.md

Usage

# Interactive mode
npx @acmeacmeio/setup-sh

# Specify agent
npx @acmeacmeio/setup-sh . --agent=claude
npx @acmeacmeio/setup-sh . --agent=codex
npx @acmeacmeio/setup-sh . --agent=cursor
npx @acmeacmeio/setup-sh . --agent=all

# New project + non-interactive
npx @acmeacmeio/setup-sh my-app --agent=all --yes

What You Get

Commands (Claude Code)

/fix-issue- TDD-powered GitHub issue workflow
/review- Code review checklist
/clean-copy- Restructure into clean commit history
/auto- Auto-detect best workflow

Rules (Cursor)

-TDD methodology (always active)
-TypeScript patterns (auto-attached on .ts/.tsx)
-REST + Zod patterns (on-demand)
-Security checklist (on-demand)

Skills (All Agents)

$api-design- REST + Zod patterns
$security-review- Security audit checklist

Hooks

-Auto-format with Prettier + ESLint on every edit
-Blocks .env modifications for security
-Intent routing suggests commands based on prompts

Customization

After setup, tailor it to your project:

CLAUDE.md- Team coding standards
.claude/commands/- Custom slash commands
.claude/skills/- Domain-specific knowledge
.cursor/rules/- Cursor MDC rules

Create *.local.md files for personal preferences (gitignored automatically).

Requirements

Node.js 18+
macOS, Linux, or Windows

← Back to home