Meet Puck

Puck is your personal Amp assistant that helps you manage everything you do in Amp: start agents, monitor them, send messages to them, create projects, and so on.

Open Puck

On ampcode.com, press Ctrl+/ from any page to open or close Puck. Puck appears over your current page, so it can use the thread or project you are viewing as context.

In the TUI, press Ctrl+O to open the command palette and select puck: open. You can also press Ctrl+X, then P.

What to Ask

Puck can handle quick requests itself or start agents to do larger pieces of work. For example:

Start an agent in ampcode/amp to investigate why CI is failing.
Find the thread where I investigated that server error.
Once this thread is done, archive it.
Create a project and start setting up its development environment.
Start one agent for each script in this repository, then summarize what they found.

Puck can keep track of the agents it starts, send them more instructions, and bring their results back to you.

Capabilities

Puck helps you start, find, and coordinate work across Amp.

Start and Steer Agents

Ask Puck to start an agent in a project. You can give the agent a coding task, ask it to investigate a problem, or send more instructions as the work continues.

Find and Manage Threads

Puck can find previous conversations, check active threads, archive completed work, and help you return to an investigation.

Work With Projects

Puck can find your existing projects, create a project, and start an agent with the right repository and environment.

Coordinate Parallel Work

Puck can split a request across several agents and gather their reports. This is useful when pieces of work can run independently.

Use Connected Services

Puck can use connected services when they are available. For example, it can inspect GitHub checks or search Slack for context. You can also talk to Puck directly from Slack through the Slack Integration.

Slack Integration

Slack is one way to talk to your personal Puck. Connect the integration, then mention @Amp in a channel or thread. See Slack Integration for setup and examples.