Alif CLI

Apply to Alif from your terminal, then let your coding agent keep your application updated with real traction.

Alif CLI is for founders using Codex, Claude Code, Hermes, Cursor agents, CI, cron, or custom scripts. You submit once, define the metric that matters, and your agent can keep that metric fresh.

Quickstart

Target command after npm publishing:

npx alif-fund apply

Packaging note: npm package names use the normal ASCII hyphen, so the package is alif-fund.

You can run directly from GitHub today:

npx github:alifdotbuild/alifcli apply

Apply:

npx alif-fund apply

The CLI will:

• send an email login code
• collect your company/application details
• create your primary metric
• save a local agent token
• print the command your agent should run next

Update traction:

npx alif-fund metric update weekly_revenue 12000

Check status:

npx alif-fund status

Generate an agent command:

npx alif-fund setup-agent weekly_revenue

Agent Usage

Agents and CI should use ALIF_API_TOKEN:

ALIF_API_TOKEN=alif_live_... \
npx alif-fund metric update weekly_revenue 12000 \
  --timestamp 2026-06-07T16:00:00Z \
  --idempotency-key acme-weekly-revenue-2026-W23 \
  --source codex

Use the same idempotency key when retrying the same reporting period. Duplicate retries are ignored.

Examples:

• Codex
• Claude Code
• Hermes
• GitHub Actions
• Cron

Commands

npx alif-fund apply
npx alif-fund login --email [email protected]
npx alif-fund status
npx alif-fund whoami
npx alif-fund setup-agent weekly_revenue
npx alif-fund metric create weekly_active_users --unit users --cadence weekly
npx alif-fund metric update weekly_revenue 12000

Hosted API

By default, the CLI uses:

https://alif-api.imuthuvappa.workers.dev

Override it when developing or self-hosting:

ALIF_API_URL=http://localhost:8787 npx alif-fund apply

Local Development

npm install
npm run build
npm run db:migrate:local
npm run dev

In another terminal:

npm exec -- alif-fund apply --api-url http://localhost:8787

Docs

• Self-hosting on Cloudflare
• Auth model
• Security notes

Status

This is an early MVP. The core loop works:

email login -> apply -> create metric -> agent updates traction -> detect growth spike