Catalog npm
PACKAGE EXPLORERView in registry

008-cli

npm

008 — Approve Cursor AI agent actions from your Android phone. An Ipenga Consulting product.

008agentaiandroidapprovalcursordeveloper-toolsipengaphone
Versions collected1
Direct dependencies4From release 0.1.0
Last observed20 Oct, 16:31 UTC

README

Current package documentation

008 — Cursor agent gate (CLI)

The agent has a license to run. You have a license to stop it.

Approve every Cursor AI agent shell/MCP/file action from your Android phone, with a 25 s timeout that fails open if the tunnel is down. An Ipenga Consulting product.

Install

npm install -g 008-cli

You'll also need cloudflared on your PATH (or 008 will use the bundled cloudflared npm package if your platform supports it). And you need Cursor.

First run

cd path/to/your-cursor-workspace
agent008 init        # writes .cursor/hooks.json for this workspace
agent008 start       # boots local server + Cloudflare tunnel, prints a QR code

Scan the QR with your Android phone. The PWA installs to your home screen and pairs with this machine. Open a Cursor agent task — every shell or MCP command pings your phone for APPROVE or DENY.

Commands

CommandWhat it does
agent008 initAdds agent008 hooks to .cursor/hooks.json in the current directory (idempotent, merges with existing).
agent008 startBoots the local WebSocket server on :7891, launches cloudflared, prints a pairing QR code.
agent008 hookThe hook Cursor calls per hooks.json. Reads stdin JSON, talks to the local server, writes {"permission":"allow"|"deny"} to stdout. Fail-open on any error.
agent008 activate <key>Validates a license key against https://008-license.vercel.app/api/validate and stores it.
agent008 statusPrints license/trial state, paths, push subscription count.

Pricing

PlanPriceWhat you get
TrialFree for 14 daysFull Solo features, no credit card
Solo$5 / month1 device, email support
Pro$11 / monthUp to 5 devices, instruction back-channel, history sync, priority support

Buy at https://008.ipengaconsulting.com

How it works

Cursor agent
  → .cursor/hooks.json
  → agent008 hook
       ↓ ws://localhost:7891
  agent008 start (WS server + cloudflared tunnel)
       ↑ wss://*.trycloudflare.com
  Android phone PWA (008-pwa.vercel.app)
       ↓ approve / deny

The 25 second decision timeout means a dead tunnel never blocks your agent — the hook returns allow and Cursor continues. Your traffic goes through your own Cloudflare Tunnel, not our servers.

Configuration

All state lives in ~/.008/config.json:

KeyPurpose
secret16-byte hex shared pairing secret (auto-generated on first run)
vapidWeb Push VAPID keypair (auto-generated)
licenseKey, licensePlan, licenseExpires, licenseValid, licenseLastCheckedSet by agent008 activate. Revalidated every 24 h. 7-day offline grace.
installedAtFirst-run timestamp — used to compute 14-day trial expiry
subscriptionsWeb Push subscriptions for connected phones
tunnel, wsUrl, lastTunnelAtLast seen tunnel URL

Environment variable overrides:

VarDefault
PORT_0087891
HOOK_WS_URLws://localhost:7891
HOOK_TIMEOUT_MS25000
LICENSE_API_URLhttps://008-license.vercel.app
PAIR_HOSThttps://008-pwa.vercel.app/pair

License

MIT. Built by Ipenga Consulting · https://ipengaconsulting.com

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases
VersionPublishedDirect dependenciesOpen version
0.1.0Registry latest18 May 20264

Package advisories

0
No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING
ipenga/008-cli

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 16:31 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:0b13f97de567ef4d71ef976ec1177c15e2d909cbf9bcbb038a98c5cc80ab902e