Your first hosted agent task
Applies to: Hosted session.
Time: 15 minutes. You'll need: a workspace admin account, an Anthropic API key, a GitHub repository connected to the workspace, and a small task you can hand off.
By the end you will have run a hosted agent on a real task at your AI provider and seen what it did. You host nothing.
1. Add the agent provider key
Open Settings, then AI. Find the card Agent provider key and paste your Anthropic API key. When you leave the field, you see "Key works". Pick a model and an effort, then click Save.
The card says "Saved. Hosted sessions can start."
2. Create a hosted agent
Open Settings, then Agents, and click Register agent. Give it a name, for example Builder. Leave Runs on as Hosted session (your provider key). Save.
On the agent, tick Review before PR if you want an automatic review pass before the pull request opens. You can also set the Cost cap per run (USD).
3. Add a repo contract (optional)
Without one, no checks run and the pull request says so. To add checks, put a file at .ithura/agent.yaml on your base branch. See The repo contract.
4. Delegate a task
Open a small task in a project that has the repository connected. Delegate it to your agent. The run starts. If no session is free yet, the run says it is waiting for a free session.
Watch the run view. It shows what the agent looks at, changes and runs.
5. Answer a question
If the agent is blocked, the task moves to Needs you with a question and a few options. Pick one or write your own answer. The run continues on the same session.
6. Review the pull request
When the agent is done, Ithura opens a pull request as the GitHub App. The body lists the summary, the decisions, the checks and their results, and the cost of the run. Review it the way you review anyone's work. Ask for changes in GitHub or in a reply on the task, and the agent picks the work up again. Merge it when you are happy.
Sometimes there is no pull request. If the agent finds the work already done, it reports that instead, and the task comes to you in Needs you with its reason. That is a finished run, not a failure, and it is common on a small first task. See Tasks that follow their pull request.
What next
- Hosted agent sessions: limits, network access, cost and branch protection.
- Stopping and steering a run
- Agent budgets