🚀 DevFactory CLI

The CLI companion for your Genius AI agents. Search, install, and manage your agent templates and custom skills directly inside your local Claude Code projects.

✨ Features

• ⚡ Fast Installation: Installs AI agents and custom skills locally into .claude/ in seconds.
• 🔍 Catalog Search: Instantly browse public or private agents directly from the command line.
• 🔐 Secure Authentication: Integrated OAuth Device Flow (browser login) or secure API token storage using your system's native keychain.
• 📦 On-The-Fly Execution: No global installation required—run instantly with npx.

📥 Installation

You can run commands directly using npx (recommended):

npx devfactory-cli <command>

Or install it globally on your system:

npm install -g devfactory-cli

Once installed, you can use the short and clean keyword devfactory directly in your terminal.

🚀 Quick Start

1. Authenticate with the Registry

Log in to your DevFactory account securely using the interactive OAuth Device Flow:

devfactory login

Alternatively, you can pass your API key directly:

devfactory login gns_your_api_key

2. Search for AI Agents

Browse the Open Agent Registry catalog for useful agent templates:

devfactory search "rust developer"

3. Install an Agent

Install a specific agent template and its associated skills into your local project workspace:

devfactory add rust-expert-agent

This automatically downloads, configures, and unpacks the agent files into your .claude/ directory, ready to be used by Claude Code.

🛠️ Command Reference

| Command | Description | Example | | :--------------- | :----------------------------------------------------------------- | :-------------------------- | | login [key] | Authenticates with the registry (OAuth or manual token) | devfactory login | | whoami | Displays active user session, API key name, and permissions | devfactory whoami | | search [query] | Searches the agent registry catalog | devfactory search scraper | | info <slug> | Shows detailed description, author, stats, and README for an agent | devfactory info ceo-agent | | add <slug> | Installs the agent template and its skills locally | devfactory add ceo-agent | | list | Lists all installed agents in the current project | devfactory list | | logout | Clears all stored credentials and credentials cache | devfactory logout |

🤝 Integration with Claude Code

The DevFactory CLI installs agents and skills matching the official structure:

your-project/
└── .claude/
    ├── agent.md         # The main active agent prompt
    └── skills/          # Custom skills and tool definitions

Once you run devfactory add <slug>, Claude Code will automatically detect the new agent guidelines and custom skills next time it boots up in your workspace.

© 2026 DevFactory — The Open Agent Registry Ecosystem.