Learn how agents work in Sculptor, including containers, Git branches, and model configuration.
What is an agent?
Agents are Sculptor’s core unit of work.
An agent is a self-contained worker that:
Runs in its own Docker container
Uses your configured Anthropic API key and model
Has its own Git repository and branch
Agent overview showing container and branch
You describe a task, and the agent reads files, edits code, runs commands, and commits changes on that branch.
Mental model: Treat each agent like a disposable feature branch: do the work, review it, merge what you like, then archive or delete it.
Where agents appear
When you start a new task, Sculptor:
Creates an agent
Shows it in the left sidebar with an auto-generated name based on your prompt
Opens a view for that agent’s conversation, changes, and logs
Each task you start creates exactly one agent.
Agents, Git, and containers
Every agent runs in a dedicated container that includes:
A copy of your project
Its own file system
A Git branch like:
Git branch created by agent
All edits and commits happen inside this container, not in your local repo, until you choose to pull them back.
This means you can:
Let agents do large refactors safely
Inspect the results in Sculptor or via Pairing Mode
Decide what to merge and what to discard
What agents can do
Inside their container, agents can:
Read and understand files across your repo
Generate or modify code
Run terminal commands (tests, builds, linters, etc.)
Create and update Git commits
Prepare changes for merge into your local branch
Agent making code changes
You can continue prompting in the same agent to refine or extend its work; it keeps the full context of the current task.
Models used by agents
Agents use Anthropic models under the hood. When configuring Sculptor, you:
Provide your Anthropic API key
Anthropic API key configuration
You can:
Change the default model for new agents
Switch an individual agent to a different model if a task needs more speed or more reasoning
Note: Model availability
The exact list of models comes from Anthropic and may change over time. Make sure you're on the latest Sculptor version to see newly supported models. See the Models page for more details.
Managing agents
From the main UI you can:
Open an agent from the sidebar to inspect its log and changes
Keep prompting in the same agent to iterate on the same branch
Delete an agent from its settings menu when you're done
Agent management in sidebar
Important: Deleting an agent removes its container and branch inside Sculptor. Any changes you already pulled into your local repo remain, but unmerged work in that agent is lost.
