Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 public command after npm publishing:

npx alif apply

Packaging note: the npm package name alif is currently owned by another publisher. Until that name is acquired or transferred, publish this package under a scoped name such as @alif/cli and run npx @alif/cli apply.

You can run directly from GitHub today:

npx github:imranye/alifcli apply

Apply:

npx alif 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 metric update weekly_revenue 12000

Check status:

npx alif status

Generate an agent command:

npx alif setup-agent weekly_revenue

Agent Usage

Agents and CI should use ALIF_API_TOKEN:

ALIF_API_TOKEN=alif_live_... \
npx alif 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:

Commands

npx alif apply
npx alif login --email founder@example.com
npx alif status
npx alif whoami
npx alif setup-agent weekly_revenue
npx alif metric create weekly_active_users --unit users --cadence weekly
npx alif 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 apply

Local Development

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

In another terminal:

node dist/cli.js apply --api-url http://localhost:8787

Docs

Status

This is an early MVP. The core loop works:

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

About

No description, website, or topics provided.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages