Documentation

Everything you need to get started with Pilos Agents and make the most of your AI development team.

Installation #

Pilos Agents is a native desktop app available for macOS, Windows, and Linux. Download the latest release from GitHub:

1. Go to github.com/pilos-ai/agents/releases
2. Download the installer for your platform (.dmg for macOS, .exe for Windows, .AppImage for Linux)
3. Run the installer and open Pilos Agents

Claude Code CLI #

Pilos Agents is a visual layer built on top of the Claude Code CLI. Authentication is handled entirely by the CLI — we never see, store, or charge for your AI usage.

1. Install the CLI: npm install -g @anthropic-ai/claude-code
2. Run claude in your terminal once to authenticate with your Anthropic account
3. Open Pilos Agents — it will detect the CLI and use your existing authentication

All credentials are managed by the Claude Code CLI and stored securely on your machine.

First Project #

Once the CLI is set up, open your first project:

1. Click the + button in the project tab bar
2. Select Browse... and choose a folder on your machine
3. Pilos Agents detects your codebase and sets up the project automatically
4. Start a new conversation and ask your AI team anything about the project

Your conversation history, project settings, and agent configurations are all stored locally in SQLite. Switch between projects anytime using the tab bar — each project preserves its own context.

Multi-Agent Mode #

Multi-Agent Mode lets you assign specialized AI agents to every conversation. Each agent has a unique role, personality, and area of expertise.

How it works

• 5 agent templates included free: PM, Architect, Developer, Designer, and Product Manager
• Each agent has a distinct system prompt that shapes its responses
• Messages are color-coded and attributed by agent
• Agents can disagree, build on each other's ideas, and provide diverse perspectives

Solo vs Team mode

Toggle between Solo mode (single agent, included in Free) and Team mode (multiple agents, Pro feature) per project. Solo mode is great for focused tasks; Team mode excels at planning, code review, and complex problem-solving.

Team presets

Quick-start with pre-configured team compositions: Full Team, Dev Team, Design Sprint, or Product. You can also build your own custom team from any combination of agents.

Terminal #

The integrated terminal is powered by xterm.js and runs directly inside Pilos Agents. No need to switch windows.

• Full terminal emulation with color support
• Multiple terminal tabs with per-tab working directory
• Claude can execute commands and display output inline
• Working directory is synced with your project folder

MCP Integrations #

Pilos Agents supports the Model Context Protocol (MCP) for connecting Claude to external tools and services.

Free templates

3 MCP integrations are included with the free tier:

• GitHub — Issues, PRs, repos, and code search
• Supabase — Database queries, auth, and storage
• Filesystem — Read, write, and search files

Pro templates

Pro unlocks 19 additional MCP integrations (22 total including the 3 free):

• Project Management — Jira, Linear
• Communication — Slack
• Design — Figma, Storybook
• Development — Playwright, Profiler, OpenAPI
• Infrastructure — Kubernetes, Terraform, Monitoring
• Database — Database Tools (PostgreSQL, MySQL, SQLite)
• Security — SAST analysis, dependency audit, secret detection
• Productivity — Google Calendar, Google Sheets
• Data — Data Pipeline, Analytics
• Quality — Accessibility Checker, i18n Manager

Custom MCP servers

You can connect any MCP-compliant server via stdio, HTTP, or SSE transport. Add custom servers in Settings → MCP Servers.

Project Memory #

Every conversation is stored locally in SQLite. Pilos Agents maintains persistent project memory so your AI team never forgets context.

• Full conversation history per project
• Per-project agent configurations and MCP server settings
• Automatically loads relevant context when you return to a project
• All data stays on your machine — no cloud sync required

Permission Modes #

Control what Claude can do in your project with granular permission modes:

• Auto-approve all — Claude acts autonomously without asking (fastest)
• Ask — Claude asks before every write or command (recommended)
• Auto-approve reads — Claude can only read files, no edits or commands (safest)

Permission modes are set per-project in Settings → Project.

License Activation #

After purchasing a Pro or Teams plan, you'll receive a license key via email (format: PILOS-PRO-XXXX-XXXX).

1. Open Pilos Agents and go to Settings → License
2. Paste your license key
3. Click Activate — Pro features unlock instantly

Your license is validated against our license server and cached locally. The app works offline after initial activation.

Agent Templates #

The free tier includes 5 core agent templates: PM, Architect, Developer, Designer, and Product Manager. Pro unlocks 26 more specialized agents (31 total):

• C-Suite: CEO, CTO, COO, CFO, CMO
• Business: Accountant, Legal, Marketing, Sales
• Engineering: Performance Engineer, API Designer, Database Specialist, Migration Expert, QA Engineer, DevOps Engineer
• Product: Growth Engineer, i18n Specialist, HR Manager, Business Analyst, Content Writer, Researcher
• Design: Accessibility Auditor, Design System Lead
• Data: Data Engineer, ML Engineer (Teams)
• DevOps: Kubernetes Specialist, SRE (Teams)
• Security: Security Auditor, Compliance Officer (Teams)

You can also create fully custom agents with your own name, emoji, color, and system prompt.

Jira Integration #

Pro includes full Jira integration via OAuth for project management:

• Connect your Atlassian instance in Settings → Integrations
• Sync epics, sprints, and stories
• Create and manage stories with acceptance criteria
• Track story coverage and push updates to Jira
• View sprint boards directly in the app

Team Sync #

Teams plan includes real-time collaboration features:

• Shared agent library across your team
• Centralized MCP server management
• Admin dashboard with role-based access
• SSO / SAML integration (coming soon)

Contact sales@pilos.net for Teams setup and onboarding.