npm install -g squads-cli

Command your
AI squads

Give your agents organization, memory, goals, and self-awareness. Let them refresh context, create squads that run autonomously, schedule routines, and trigger activity based on custom conditions.

View on GitHub View on npm

terminal

$ squads status

squads status
  ● 7 active sessions across 1 squad (claude 7)

  11/11 squads  │  memory: enabled

  ┌────────────────────────────────────────────────────────┐
  │ SQUAD           AGENTS  MEMORY        ACTIVITY │
  ├────────────────────────────────────────────────────────┤
  │ cli             8       3 entries     today       │
  │ engineering     6       1 entry       today       │
  │ intelligence    24      1 entry       today       │
  │ customer        4       3 entries     today       │
  │ website         10      1 entry       today       │
  │ marketing       4       2 entries     2d ago      │
  │ finance         2       1 entry       3d ago      │
  └────────────────────────────────────────────────────────┘

  $ squads dash             Full dashboard
  $ squads run <squad>     Execute a squad

Real production data: 11 squads, 69 agents, $758/week in AI costs.

First-time install

What to expect when you install squads-cli

Install globally

$ npm install -g squads-cli

added 42 packages in 3s

✓ squads-cli installed successfully

Initialize in your project

$ squads init

✓ Created .agents/squads/ directory

✓ Created example squad: engineering

✓ Created .agents/memory/ directory

✓ Created .agents/sessions/ directory

Next steps:

$ squads status See your new squad

$ squads dash Full dashboard view

Check status

$ squads status

● 0 active sessions

1/1 squads │ memory: enabled

engineering 3 none —

Set your first goal

$ squads goal set engineering "Ship auth feature"

● Goal added to engineering

Ship auth feature

Ready to run your squads!

Full installation guide →

Simple commands, powerful results

Everything you need in a handful of commands

squads status All squads overview

squads dash Full dashboard with goals

squads run <squad> Execute a squad

squads memory query "<topic>" Search squad memory

squads goal set <squad> "<goal>" Set a goal

squads feedback add <squad> 5 "Great" Rate execution

Everything squads need

Organization, memory, goals, and feedback in one CLI.

Squad management

Organize agents into domain-aligned teams. Engineering, research, marketing — each squad has its own context.

Persistent memory

Squads accumulate knowledge across sessions. Query memory, update state, build institutional knowledge.

Goal tracking

Set objectives, track progress, mark complete. Keep squads aligned on what matters.

Feedback loop

Rate executions, log learnings, improve over time. Squads get better with every run.

Claude Code native

Session hooks inject squad context automatically. Claude knows what your squads are working on.

Markdown-based

Files first, infrastructure when needed. Agents are markdown files, squads are folders. Scale to Postgres, Redis, and smart triggers as you grow.

Files first, infrastructure when needed

Agents are markdown files. Squads are folders. Memory is state files. Start with just files you can read, edit, and version control. Add infrastructure (Postgres, Redis, triggers) as you scale.

.agents/squads/ — Squad definitions and agents

.agents/memory/ — Persistent state files

SQUAD.md — Squad config, goals, agent list

*.md — Agent prompts and instructions

# project structure

.agents/

squads/

engineering/

SQUAD.md # config + goals

ci-optimizer.md

code-reviewer.md

research/

SQUAD.md

market-analyst.md

memory/

engineering/state.md

research/state.md

Get started in seconds

One install, one init, you're ready

1 npm install -g squads-cli Install globally

2 squads init Initialize project

3 squads dash See your squads

Full documentation →

Command your AI squads