Labs CLI

Labs is a powerful, deterministic agentic runtime for your terminal. It brings structured planning and reliable tool execution to your local development environment.

Installation

Instant Run (No Install)

The recommended way to run Labs is via npx. This ensures you always use the latest version and requires no setup.

npx @notapublicfigureanymore/labs-cli

Global Install

If you prefer to have the labs command available everywhere:

npm install -g @notapublicfigureanymore/labs-cli

Then run it:

labs

Features

• Agentic Workflow: Uses the "Ralph Loop" to plan and execute complex tasks.
• Local & Cloud Models: Supports local GGUF models (via node-llama-cpp) or cloud providers (Anthropic, OpenAI, etc.).
• Terminal Integration: Can run shell commands, manage files, and navigate your project.
• Browser Capability: Includes headless browsing for research and documentation.

Configuration

Labs looks for configuration in ~/.labs/config.env or environment variables.

Supported Providers

• Local (Default): Uses embedded GGUF models.
• Anthropic: Set LABS_PROVIDER=anthropic and ANTHROPIC_API_KEY.
• Ollama: Set LABS_PROVIDER=ollama.
• OpenRouter: Set LABS_PROVIDER=openrouter.

License

MIT