⚡ Moven CLI (moven_npx / npx moven)

Automated AI Agent Safety Setup & Project Auto-Discovery CLI. Zero-config installer that scans your codebase for model usage, registers your agent identity, generates moven.config.ts, and pairs telemetry with the Moven AI Dashboard.

💡 What does npx moven do?

moven_npx is the zero-config setup CLI for Moven AI. When executed in any AI project repository, it automatically:

1. 🔍 Framework Auto-Discovery: Inspects your project dependencies (LangChain, LlamaIndex, Vercel AI SDK, CrewAI, AutoGen, OpenAI, Anthropic, Gemini).
2. 🤖 Model Inspection: Scans source files for active model declarations (gpt-4o, claude-3-5-sonnet, gemini-2.5-flash).
3. 🔐 Browser Token Authentication: Launches an interactive magic-link login (https://moven.dev/auth/cli-login) to pair with your workspace.
4. ⚙️ Config Generation: Generates a type-safe moven.config.ts file customized for your project setup.
5. 🔑 Environment Injection: Safely appends MOVEN_API_KEY into your local .env.

🚀 Quickstart

Run the installer directly in your project root via npx:

npx moven_npx
# or
npx moven

📋 Example Interactive CLI Flow

⚡ Moven AI Agent Protection Installer
----------------------------------------
[✓] Framework Detected: LangGraph / LangChain
[✓] Models Detected: openai/gpt-4o-mini, anthropic/claude-3-5-sonnet
[✓] Launching Browser Auth: http://localhost:3000/auth/cli-login?token=cli_7a8f92b...
[✓] Pairing successful! Organization: Acme Corp | Project: Inventory Assistant
[✓] Created moven.config.ts
[✓] Appended MOVEN_API_KEY to .env

🎉 Setup Complete! Your agent is protected with Moven Circuit Breaker.

🛠️ CLI Options

| Flag | Short | Description | | :--- | :--- | :--- | | --yes | -y | Skip interactive prompts and use auto-detected defaults | | --project <name> | -p | Manually specify project name | | --api-key <key> | -k | Pass API key directly without launching browser login | | --config-only | -c | Only generate moven.config.ts without browser auth |

🤝 Contributing

We welcome community contributions! Please read our CONTRIBUTING.md for details on setting up the local CLI development environment and submitting pull requests.

📜 License

MIT © Moven AI