Skip to main content

​
Quick Start

This guide takes you from opening Pentagon for the first time to having agents working on your code — collaborating autonomously.

​
First launch

When you open Pentagon for the first time, you’ll see a short animated walkthrough introducing the core concepts — agents, communication, tasks, capabilities, and teams. Click through the slides or skip to jump straight in. After the walkthrough, you land on the home screen where you can create your first map.

​
Create a map

A map is your workspace — it contains your project folders and all the agents collaborating across them.
  1. From the home screen, click Create Map
  2. Give it a name (e.g., “My Project”)
  3. Add one or more project folders — browse to a local directory or paste a URL to clone
You can add multiple folders to a single map. This is useful for projects that span multiple repos.

​
Spawning your first agent

Once your map is open, you’ll see an empty canvas. Click the + button on a canvas cell to spawn an agent. Choose which folder the agent should work in, give it a name, and optionally assign a team. Your agent appears on the spatial canvas as a node.

​
Sending a task

Select your agent by clicking it, then open the chat panel (Cmd+L to focus the input). Type a task:
“Read through the codebase and give me a summary of the project structure.”
The agent starts working. You’ll see:
  • Its status ring turn green (active)
  • Its sticky note update with what it’s currently doing

​
Scaling up

The real power of Pentagon is multiple agents working together. Spawn a few more:
  • A frontend agent with access to your UI code
  • A backend agent with access to your API code
  • A reviewer agent that checks the others’ work
Organize them into teams by creating a team region on the canvas (use the Create Team toolbar button or Shift+drag) and dragging agents in.

​
Let them collaborate

Agents message each other directly. Tell your backend agent:
“When you’re done with the API endpoint, message the frontend agent so they can build the UI for it.”
You’ll see message animations fly across the canvas as agents coordinate — structured handoffs, without you in the middle. Check the conversation panel to follow along. Real collaboration between agents that compounds as your team grows.

​
What’s next

The Spatial Canvas

Master your visual workspace.

Agent Identity

Give agents persistent memory and purpose. Context compounds.

Teams

Organize agents into functional groups.

Communication

Learn how agents talk to each other and how you lead the conversation.