~/ace $ ace/v1 · loading environment spec · ok

ACE is npm for agentic coding environments.

An open, Git-native package ecosystem for reproducible orchestrator-driven agentic coding environments. An ACE package describes the environment — orchestrator, workers, tools, models, policies, memory, lifecycle — not application source. Git remains the source of truth; the registry indexes specifications.

node ace-proagents/ace.mjs init --name my-workspace

★ on product hunt mit-style free zero runtime deps spec ace/v1 git-native orchestrator: opencode

exp-007 · MVP phases 1–6

$ ace init && ace run

demo output: synthetic lines, real command structure from README

node ../ace-proagents/ace.mjs init --name my-workspace

wrote package.json · spec ace/v1 · orchestrator=opencode · workers=5

node ../ace-proagents/ace.mjs install

resolved ace@0.1.0 · integrity sha256 · lockfile ace-lock.json

node ../ace-proagents/ace.mjs run

runtime started · network=restricted · filesystem=workspace · memory=persistent

node ../ace-proagents/ace.mjs status

agents 5 · tasks 0 · events 0 · state: running

$ cat package.json

spec: ace/v1
orchestrator: opencode
workers: architect · frontend · backend · tester · reviewer
tools: git · github · filesystem · terminal
network: restricted
filesystem: workspace
memory: persistent
policy: require_review_before_merge
lifecycle: autonomous · restart_on_failure
lockfile: ace-lock.json · sha256 integrity

the ace key: environment specification

"ace": {
  "spec": "ace/v1",
  "orchestrator": { "runtime": "opencode" },
  "agents": {
    "strategy": "dynamic",
    "workers": [
      { "role": "architect" },
      { "role": "frontend" },
      { "role": "backend" },
      { "role": "tester" },
      { "role": "reviewer" }
    ]
  },
  "network":  { "mode": "restricted" },
  "policies": { "require_review_before_merge": true },
  "lifecycle": { "autonomous": true, "restart_on_failure": true },
  "entry": {
    "manifest": "package.json",
    "main": "ace.mjs",
    "lockfile": "ace-lock.json"
  }
}

Package files are public (package.json, its ace key, README.md). Runtime state under .ace/ is private and never published.

$ ace --help

ace init [--name <n>]scaffold a package

ace install [<pkg>]install from local registry, or a git ref

ace listinstalled packages

ace search <q>search the local registry

ace runstart the runtime

ace statushuman overview

ace context [--json]environment context

ace agentslist agents

ace events [--limit N]event stream

ace snapshot / restore <id>snapshot and roll back the environment

ace stopgraceful stop

$ ace install github:<owner>/<repo>

ace install github:EnzoVezzaro/fullstack-team

cloned · resolved spec · wrote ace-lock.json

ace install github:EnzoVezzaro/fullstack-team#v1.2.0

pinned to ref v1.2.0 · integrity recorded

Git-native install works without a registry. Git remains the source of truth; the registry only indexes specifications.

the target UX (README, “the killer experience”)

npm install -g ace
ace install @ace/fullstack
ace run
ace status

Published to npm when ACE ships 1.0; until then the quick start above is what runs today.

$ ls .ace/

runtime state: private, never published

.ace/
├── state.json           # status, active agent, agents[], tasks[]
├── events.jsonl         # append-only event stream
├── agents/<id>.json
├── tasks/<id>.json
├── context/context.json
└── snapshots/<id>.json

{ "type": "task.start", "agent": "frontend", "seq": 1 }

{ "type": "task.done", "agent": "backend", "seq": 2 }

{ "type": "review.request", "policy": "require_review_before_merge", "seq": 3 }

example event shapes, structure from the ace/v1 event stream

$ ace status

ACE is an MVP (phases 1–6), MIT-style free, zero runtime dependencies. The environment you just watched is the environment you get: orchestrator, workers, tools, models, policies, memory, lifecycle, described in one manifest, locked by hash, restored anywhere.

pricing · what ACE costs today

ACE core · MVP phases 1–6$0.00

runtime dependencies0

git-native install$0.00

ACE Pro · optional support sub$9.00/mo

total to install ACE$0.00

cd my-workspace && node ../ace-proagents/ace.mjs run

ACE Pro is a $9.00 USD/month support subscription, billed through Stripe. Opening checkout needs JavaScript; the direct link is buy.stripe.com/9B6dRaclLgbjbqx1bB28800. Cancel any time. ACE itself stays MIT-style and free.

quick start init, install, run — copy-paste commands, zero dependencies. the plan MVP phases 1–6: scope, order of work, what ships when. product spec what ACE is: manifest, agents, policies, lifecycle. source MIT on GitHub — issues and PRs open.