CLI verbs

ahamie create | dev | build | deploy
        | ui add
        | publish | install
        | login | logout
        | run | eval | factory run | triggers list
        | db migrate | db studio
        | secrets set | secrets list
        | doctor

create

ahamie create my-brain

Delegates to pnpm create ahamie.

dev

ahamie dev [--port 3000] [--proxy-port 7787]

Boots the proxy as a child process, prints the listen URL, generates a per-launch bearer token in AHAMIE_PROXY_TOKEN if unset.

build

ahamie build

Delegates to tsup.

deploy

ahamie deploy

v1: Helm chart. v2: Terraform.

ui add

ahamie ui add agent-run-tree run-console approval-inbox

Calls pnpm exec shadcn add with the registered Ahamie primitive.

publish / install

ahamie publish --manifest ./src/manifests/my-app.ts
ahamie install --hash <sha256>

Local registry today; @ahamie/marketplace at v2.

login / logout

Better-Auth machine-token flow (v1 implements PKCE device flow).

run

ahamie run --id daily-summary [--shadow]

Manually invoke an automation. --shadow records but does not dispatch deliveries.

eval

ahamie eval --suite summarizer.suite
ahamie eval --file ./src/evals/custom.suite.ts

Loads the suite, runs both partitions, exits non-zero on failure.

factory run

ahamie factory run --file ./src/factories/summarizer.factory.ts

Runs the software-factory outer loop with a tabu list across iterations.

triggers list

ahamie triggers list

Lists every registered trigger family in the current process (built-ins + connector augmentations).

db migrate / db studio

ahamie db migrate [--url postgres://…]
ahamie db studio

secrets

ahamie secrets set --name slack-prod-webhook --purpose connector --org $ORG_ID
ahamie secrets list --org $ORG_ID

doctor

ahamie doctor

Preflight checks: missing eval suites, default-allow egress, unrotated credentials, missing ahamie.config.ts, etc.