Introduction

AI-native project management that keeps your code local and your planning in the cloud.

What is Locus?

Locus is an AI-native project management platform designed for teams that use AI coding agents. It separates planning (in the cloud) from execution (on your machine), so your source code never leaves your infrastructure.

Locus works with Claude (Anthropic) and Codex (OpenAI) as AI providers. You choose which agent runs your tasks.

How it works

1. Plan — Create sprints and tasks in the Locus Dashboard, or let AI plan them for you with locus plan

2. Dispatch — Tasks are dispatched to your local machine where AI agents claim and execute them

3. Execute — Agents work in isolated git worktrees, keeping each task's changes separate

4. Review — Agents create pull requests, and you can review them with locus review or via the Telegram bot

---

Key Features

Local Execution

AI agents run on your machine or your server. Source code is never uploaded to any third-party service. Locus only syncs task metadata, status updates, and project context — never your codebase.

Multi-Agent

AI Sprint Planning

Telegram Control

---

Quick Start

Get up and running in under 2 minutes:

# Install the CLI
npm install -g @locusai/cli

# Initialize in your project
cd your-project
locus init

# Configure your API key
locus config setup

# Start working on tasks
locus run

That's it. Locus will claim the next available task from your active sprint, execute it with your chosen AI provider, and create a pull request when done.

---

Architecture Overview

Locus syncs task metadata only with the cloud — titles, descriptions, statuses, and acceptance criteria. Your source code stays entirely on your machine.

---

What's Next?

Installation

Install the Locus CLI and get your environment ready. Get started →

Telegram Bot

Control your agents from Telegram. Learn more →

CLI Reference

Explore all commands and options. View commands →

Self-Hosting

Deploy agents on your own server for 24/7 execution. Setup guide →