Factory Droid

Install Droid CLI

curl -fsSL https://app.factory.ai/cli | sh

For the latest installation instructions and platform-specific guidance, visit the Factory AI CLI documentation.

Authenticate with Factory AI

To use Droid in Vibe Kanban, you must first authenticate:

Alternatively, generate an API key from Factory Settings and set it as an environment variable:

export FACTORY_API_KEY=fk-...

For detailed authentication instructions, see the Factory AI documentation.

Start Vibe Kanban

Once authenticated, launch Vibe Kanban:

npx vibe-kanban

You can now select Factory Droid when creating task attempts.

Configuration Options

Droid supports several configuration options in Vibe Kanban:

Autonomy Level: Controls permission level for file and system operations
- normal: Read-only mode – safe for reviewing planned changes without execution
- low: Basic file creation/editing while blocking system changes
- medium: Development operations with recoverable side effects
- high: Production operations with security implications or major side effects
- skip-permissions-unsafe: Bypasses all permission checks (use only in isolated environments) (default)
Model: Specify which model to use
Reasoning Effort: Control the reasoning depth
- off: Minimal reasoning
- low: Light reasoning
- medium: Balanced reasoning
- high: Deep reasoning for complex tasks

These options can be configured when creating agent configurations in Vibe Kanban.