Assign a task to an AI coding agent and let it work on the implementation while you focus on something else.
This feature may need to be enabled for your workspace.
Background agents let you hand off implementation work from a task directly to an AI coding agent. You select a task, point the agent at your repository, and it runs autonomously — reading the task description, understanding the codebase, writing code, and opening a pull request when it's done. You don't need to wait for it to finish. The agent works in the background and reports status back as it progresses.
This is designed for teams that want to move from a written brief and task list to working code without manual hand-off steps. Once your plan is generated and tasks are defined, individual tasks can be delegated to a background agent for execution.
Select a task — Navigate to a task in a brief's task list. Background agents work at the individual task level. The task's title, description, acceptance criteria, and any subtasks are all passed to the agent as context.
Configure the run — Specify the repository URL and branch the agent should work from. You can optionally set the target branch name for the pull request and provide additional context instructions for the agent.
Launch the agent — The agent starts working immediately. Hamster records the run and begins receiving status updates from the agent provider as the run progresses.
Track progress — The task view shows the current agent run status. When the agent completes, it opens a pull request in your repository. The run record in Hamster links to the PR so your team can review the work.
When you launch a background agent for a task, it receives:
The agent uses this to understand not just what to build, but why — which leads to more contextually appropriate implementation decisions.
Each run moves through a set of states that Hamster tracks and displays:
Only one background agent run can be active for a given task at a time. If you try to launch a second run while one is in progress, you'll need to wait for it to finish or cancel it first.
Background agents require an API key for the agent provider connected to your workspace. The key is stored securely in your workspace vault and used to authenticate agent launch requests.
To configure:
Once configured, the option to launch a background agent becomes available on any task in your workspace.
Full task context: The agent reads the brief document alongside the task, so it understands the broader project before writing any code.
Pull request creation: By default, the agent opens a pull request when it finishes. The PR is linked back to the task run in Hamster.
Real-time status updates: The task view stays current as the run progresses, without manual refreshing.
Run history: Each agent run is recorded with its status, timestamps, and outcome. You can review the history of runs on a task over time.
Non-blocking: Launching an agent doesn't block you in any way. Close the tab, work on something else, or start another session — the agent continues running independently.