AGNY CLI

🔥 Track your Brain RPM - The passive intensity tracker for AI-native builders.

Quick Start

# Login with GitHub
agny login

# Install background daemon (one-time)
# Supports macOS (LaunchAgent) & Windows (Startup VBS)
agny install

# Done! AGNY now tracks your AI usage automatically in the background.

Commands

| Command | Description | |---------|-------------| | agny watch | Start monitoring AI tools manually | | agny login | Login with GitHub | | agny logout | Logout | | agny whoami | Check current account | | agny install | Install background daemon | | agny uninstall | Remove background daemon | | agny status | Check daemon status | | agny submit | Manually submit usage data |

Supported Tools

• ✅ Cursor
• ✅ Claude Desktop
• ✅ Windsurf
• 🔜 Copilot

Development

# Install dependencies
npm install

# Build
npm run build

# Run in dev mode
npm run dev <command>

Publishing to npm

⚠️ IMPORTANT: DO NOT run npm publish locally!

Cross-platform native binaries are built by GitHub Actions. Publishing locally will fail the prepublishOnly check.

Use git tags to trigger automatic CI/CD release:

# 1. Update version (patch/minor/major)
npm version patch

# 2. Push with tags
git push origin main --tags

# 3. GitHub Actions (Release.yml) will:
#    - Build binaries for 6 platforms (macOS/Linux/Windows × x64/ARM)
#    - Publish to npm
#    - Create GitHub Release

License

MIT