Org2

Docs website: https://org2.avi.press/

For now, the canonical project docs live on the website.

Agent discovery

After installing the CLI, agents can inspect the exact capabilities of that version without relying on model memory:

org2 agent capabilities
org2 agent --help

The first command emits the versioned org2:capabilities:v1 JSON manifest with workflow families, safety rules, client roles, and canonical documentation links. See https://org2.avi.press/agent-quickstart.html.

Development

Run the full test suite with:

npm test

Benchmark read-only CLI operations against a representative corpus with:

npm run benchmark:cli -- --dir /path/to/corpus
npm run benchmark:cli -- --dir /path/to/corpus --suite full --runs 3

The interactive suite covers startup, agenda, search, approvals, and an isolated full index build. The full suite also covers full and incremental compilation, lint, graph audit, and cold/warm agent context. Index and cache output is redirected to a temporary directory; the source corpus and its live index are not modified.

The normal test suite also includes a reproducible performance regression test over a generated 500-file, 5,500-node corpus. Run it independently with:

npm run test:performance

It enforces explicit budgets for CLI startup, compilation, lint, graph audit, cold/warm agent context, and a one-file incremental rebuild. On known slower CI hardware, multiply all budgets with ORG2_PERF_BUDGET_SCALE=2 npm run test:performance rather than weakening the checked-in defaults.

Build or update the local macOS app bundle with:

make macos-app

The equivalent npm script is npm run build:macos-app. The daily-app command builds an optimized release binary by default. Use the explicit variants when switching modes during development:

npm run build:macos-app:release
npm run build:macos-app:debug
npm run build:macos-app:codex          # isolated debug app
npm run build:macos-app:codex:release  # isolated optimized app

The build refuses to place an implicit debug binary at the daily app’s bundle identifier; only the explicit :debug command authorizes that. The app reports Debug or Optimized release under its audio/runtime settings, and the bundle records the same mode as Org2BuildConfiguration in Info.plist.

By default this writes to ~/Applications/Org2Workspace.app, signs it with bundle id org.org2.workspace, and uses the first available stable code-signing identity. Stable signing matters for macOS Screen/System Audio permissions; ad-hoc signing changes the app’s TCC identity on each rebuild. Override the signing identity with ORG2_WORKSPACE_CODE_SIGN_IDENTITY, or set it to adhoc to force ad-hoc signing. Override the app path or bundle id with ORG2_WORKSPACE_APP_PATH or ORG2_WORKSPACE_BUNDLE_ID when needed. On Apple Silicon it builds arm64 by default; override with ORG2_WORKSPACE_SWIFT_ARCH if needed.

The canonical test layout is test/ for Node test scripts, with feature subdirectories for nearby fixtures when useful. Agent/context-pack coverage lives under test/agent/; run a targeted agent test with node test/agent/test-agent-context.mjs after npm run build.