{"_id":"@bowlofnoodles/agent-harness","name":"@bowlofnoodles/agent-harness","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@bowlofnoodles/agent-harness","version":"1.0.0","description":"A full-stack project scaffolding tool based on harness-engineering architecture for continuous autonomous development","type":"module","main":"dist/index.js","bin":{"agent-harness":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","lint":"eslint src/ --ext .ts","lint:fix":"eslint src/ --ext .ts --fix","test":"vitest run","test:watch":"vitest"},"keywords":["scaffold","harness","agent","fullstack","cli"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/bowlofnoodles/agent-harness.git"},"engines":{"node":">=18.0.0"},"dependencies":{"@types/fs-extra":"^11.0.4","@types/node":"^20.19.37","@types/uuid":"^9.0.8","chalk":"^5.6.2","commander":"^12.1.0","eventemitter3":"^5.0.4","fs-extra":"^11.3.4","glob":"^10.5.0","inquirer":"^9.3.8","ora":"^8.2.0","typescript":"^5.9.3","uuid":"^9.0.1","winston":"^3.19.0","yaml":"^2.8.3","zod":"^3.25.76"},"devDependencies":{"@types/inquirer":"^9.0.9","@typescript-eslint/eslint-plugin":"^7.18.0","@typescript-eslint/parser":"^7.18.0","eslint":"^8.57.1","tsx":"^4.21.0","vitest":"^1.6.1"},"_id":"@bowlofnoodles/agent-harness@1.0.0","gitHead":"e730df185ef33fda50642137fc2fa4fe69ec2306","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/bowlofnoodles/agent-harness/issues"},"homepage":"https://github.com/bowlofnoodles/agent-harness#readme","_nodeVersion":"20.20.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-EHWdLCMdRMGvj1rTrt6skzswV52Zeb1Ba7nzekX9QY/0X5O4KmXjUZrv8vNd4aY+LoEYAaxVaYLJuHHp2f5xWQ==","shasum":"81ca9f0606f13c00c36c4bd8d29adfc389649e53","tarball":"https://registry.npmjs.org/@bowlofnoodles/agent-harness/-/agent-harness-1.0.0.tgz","fileCount":137,"unpackedSize":351947,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bowlofnoodles%2fagent-harness@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCID6pwWSdGl4ckwlnr7BrtJqSuGwo+vDgRne+q5XGpOjzAiA/oZHIqRcvLhp9ku+dEFdH7OrrY7nruahycGw3+yTCHA=="}]},"_npmUser":{"name":"jerry_cheung","email":"huahuazfh@qq.com"},"directories":{},"maintainers":[{"name":"jerry_cheung","email":"huahuazfh@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-harness_1.0.0_1775122100799_0.32138915670353096"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-02T09:28:20.710Z","1.0.0":"2026-04-02T09:28:21.005Z","modified":"2026-04-02T09:28:21.422Z"},"maintainers":[{"name":"jerry_cheung","email":"huahuazfh@qq.com"}],"description":"A full-stack project scaffolding tool based on harness-engineering architecture for continuous autonomous development","homepage":"https://github.com/bowlofnoodles/agent-harness#readme","keywords":["scaffold","harness","agent","fullstack","cli"],"repository":{"type":"git","url":"git+https://github.com/bowlofnoodles/agent-harness.git"},"bugs":{"url":"https://github.com/bowlofnoodles/agent-harness/issues"},"license":"MIT","readme":"# @bowlofnoodles/agent-harness\n\nA full-stack project scaffolding CLI tool powered by the **harness-engineering** architecture — designed for continuous development with AI coding agents (Claude Code, GitHub Copilot, etc.).\n\n## Tech Stack\n\n| Layer | Technology |\n|-------|-----------|\n| **Frontend** | React 18 + TypeScript + Vite |\n| **Backend** | Nest.js + TypeScript |\n| **Database** | Prisma + PostgreSQL |\n| **AI Agents** | Claude Code · GitHub Copilot |\n\n## Architecture Flow\n\n```\n┌──────────────────────────────────────────────────────────────────────┐\n│                                                                      │\n│   developer / AI agent (Claude Code, Copilot)                        │\n│        │                                                             │\n│        ▼                                                             │\n│   ┌──────────────┐                                                   │\n│   │  agent-harness│  CLI                                             │\n│   │  init / scaffold / guide / status / run                          │\n│   └──────┬───────┘                                                   │\n│          │                                                           │\n│   ┌──────┴──────────────────────────────────────┐                    │\n│   │              Agent Core Engine               │                   │\n│   │  ┌──────────┐ ┌────────┐ ┌───────────────┐  │                   │\n│   │  │TaskQueue │ │ Memory │ │    Config      │  │                   │\n│   │  │(priority,│ │(persist│ │  (.harness.yaml│  │                   │\n│   │  │ deps,    │ │ facts) │ │   + Zod)      │  │                   │\n│   │  │ retries) │ │        │ │               │  │                   │\n│   │  └──────────┘ └────────┘ └───────────────┘  │                   │\n│   └──────┬──────────────────────────────────────┘                    │\n│          │                                                           │\n│   ┌──────┴──────┬──────────────┬─────────────────┐                   │\n│   ▼             ▼              ▼                 ▼                   │\n│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐             │\n│ │  Tools   │ │ Scaffolds│ │Validation│ │ AI Agent     │             │\n│ │          │ │          │ │ Pipeline │ │ Instructions │             │\n│ │•filesys  │ │• react   │ │          │ │              │             │\n│ │•shell    │ │• nestjs  │ │• lint    │ │• CLAUDE.md   │             │\n│ │•git      │ │          │ │• test    │ │• copilot-    │             │\n│ │•(custom) │ │          │ │• security│ │  instructions│             │\n│ └──────────┘ └──────────┘ └──────────┘ └──────────────┘             │\n│                    │                                                 │\n│                    ▼                                                 │\n│   ┌─────────────────────────────────────────┐                        │\n│   │       Generated Project (monorepo)       │                       │\n│   │                                          │                       │\n│   │  frontend/          backend/             │                       │\n│   │  ├── src/            ├── src/            │                       │\n│   │  │   ├── App.tsx     │   ├── main.ts     │                       │\n│   │  │   ├── components/ │   ├── app.module   │                       │\n│   │  │   └── pages/      │   ├── auth/       │                       │\n│   │  ├── CLAUDE.md       │   ├── health/     │                       │\n│   │  └── .github/        │   ├── prisma/     │                       │\n│   │     copilot-         │   ├── CLAUDE.md   │                       │\n│   │     instructions.md  │   └── .github/    │                       │\n│   │                      │      copilot-     │                       │\n│   │                      │      instructions │                       │\n│   └─────────────────────────────────────────┘                        │\n│                    │                                                 │\n│                    ▼                                                 │\n│          AI agent reads CLAUDE.md /                                  │\n│          copilot-instructions.md and                                 │\n│          builds features continuously                                │\n│                                                                      │\n└──────────────────────────────────────────────────────────────────────┘\n```\n\n## Quick Start\n\n```bash\n# Install globally\nnpm install -g @bowlofnoodles/agent-harness\n\n# Or install dependencies for local development\nnpm install\n\n# Build the CLI tool\nnpm run build\n\n# Initialize harness config in your project\nnpx agent-harness init\n\n# Generate a fullstack project (React frontend + Nest.js backend)\nnpx agent-harness scaffold -t react -n frontend\nnpx agent-harness scaffold -t nestjs -n backend\n\n# Open with an AI coding agent\ncd frontend && claude    # or open in VS Code with Copilot\ncd backend  && claude    # AI reads CLAUDE.md for context\n```\n\n## CLI Commands\n\n### `agent-harness init`\n\nInitialize Agent Harness configuration in the current directory.\n\n```bash\nagent-harness init\nagent-harness init -n my-project\n```\n\nCreates `.harness.yaml` config and `.harness/` directory.\n\n### `agent-harness scaffold`\n\nGenerate a new project scaffold with interactive prompts.\n\n```bash\n# Interactive mode\nagent-harness scaffold\n\n# Non-interactive mode\nagent-harness scaffold -t react -n frontend\nagent-harness scaffold -t nestjs -n backend\n\n# Specify output directory\nagent-harness scaffold -t nestjs -n api -o ./projects\n```\n\n| Template | Type | Description |\n|----------|------|-------------|\n| `react` | Frontend | React 18 + Vite + TypeScript + Tailwind + React Router + Zustand |\n| `nestjs` | Backend | Nest.js + TypeScript + Prisma + JWT Auth + Swagger + Docker |\n\nEach generated project includes:\n- `CLAUDE.md` — AI instructions for Claude Code\n- `.github/copilot-instructions.md` — AI instructions for GitHub Copilot\n\n### `agent-harness guide`\n\nShow AI agent workflow guides.\n\n```bash\n# Overview of all supported AI agents\nagent-harness guide\n\n# Detailed guide for a specific agent\nagent-harness guide --agent claude-code\nagent-harness guide --agent copilot-cli\n```\n\n### `agent-harness status`\n\nShow agent status, registered tools, scaffolds, and queue stats.\n\n```bash\nagent-harness status\n```\n\n### `agent-harness run`\n\nStart the agent loop for continuous task processing.\n\n```bash\nagent-harness run           # Continuous mode\nagent-harness run --once    # Process one task and exit\n```\n\n## AI Agent Workflow\n\nAgent Harness generates projects that are **AI-agent-ready** out of the box. Every scaffolded project includes instruction files that popular AI coding tools read automatically.\n\n### With Claude Code\n\n```bash\n# 1. Generate a project\nagent-harness scaffold -t nestjs -n backend\n\n# 2. Open with Claude Code\ncd backend && claude\n\n# Claude automatically reads CLAUDE.md and understands:\n# - Project structure & conventions\n# - Available commands\n# - How to add new modules\n# - Code style rules\n\n# 3. Ask Claude to build features\n# \"Add a users CRUD module with Prisma model\"\n# \"Write unit tests for the auth service\"\n# \"Create a products endpoint with pagination\"\n```\n\n### With GitHub Copilot\n\n```bash\n# 1. Generate a project\nagent-harness scaffold -t react -n frontend\n\n# 2. Open in VS Code (Copilot reads .github/copilot-instructions.md)\ncd frontend && code .\n\n# 3. Use Copilot Chat\n# @workspace \"How do I add a new page?\"\n# @workspace \"Create a user profile component\"\n# \"Explain this React hook\"\n```\n\n### Workflow Diagram\n\n```\n  ┌──────────┐     scaffold      ┌──────────────────┐\n  │  agent-  │ ───────────────►  │  Generated        │\n  │  harness │                   │  Project          │\n  │  CLI     │                   │  ├── CLAUDE.md    │\n  └──────────┘                   │  ├── .github/     │\n                                 │  │   copilot-     │\n                                 │  │   instructions │\n       ┌─────────────────────────┤  └── src/...      │\n       │                         └──────────────────┘\n       ▼                                  │\n  ┌──────────┐                            │\n  │ AI Agent │◄───────────────────────────┘\n  │          │  reads instructions\n  │• Claude  │  understands structure\n  │  Code    │  builds features\n  │• Copilot │  runs tests\n  └──────────┘\n```\n\n## Development\n\n```bash\n# Run the CLI in development mode\nnpm run dev\n\n# Run all tests\nnpm test\n\n# Run tests in watch mode\nnpm run test:watch\n\n# Lint\nnpm run lint\n\n# Build\nnpm run build\n```\n\n## Configuration\n\nAgent Harness stores its config in `.harness.yaml`:\n\n```yaml\nprojectName: my-project\nlogLevel: info\nmaxConcurrentTasks: 3\ndefaultScaffold: nestjs\nvalidation:\n  lintOnSave: true\n  testOnCommit: true\n  securityScan: true\ngit:\n  autoCommit: true\n  commitPrefix: \"[harness]\"\n  branch: main\n```\n\n## Architecture\n\nSee [docs/architecture.md](docs/architecture.md) for the full architecture documentation.\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-c0ce548e3efd8d9886ecdac3ac930579"}