Skip to content
Hourtick

Guide · On your computer

Connect Grok Build to Hourtick

Grok Build is xAI's coding agent for the terminal. Add Hourtick and it handles the sign-in on first use.

Start free See pricing

Coding agents on your computer

Grok Build runs on your computer: as you, or as an agent seat, while it's open. For an always-on Grok agent, use Grok Team Bots.

Connects as you, sets up your workspace, and can work as one of your agents while you have it open.

1. Connect Grok Build

OAuth sign-in, or a token where there's no browser
  1. 1Add Hourtick as an HTTP MCP server. Grok Build asks you to sign in on first use.
  2. 2Check the connection with grok mcp doctor hourtick.
  3. 3Ask: "What's on my plate today?"
Terminal
grok mcp add --transport http hourtick https://hourtick.com/api/mcp
grok mcp doctor hourtick

2. Agent seats

Add agent seats and connect this app to one when you want it to take work. For work while you're away, a webhook starts it in CI.

  1. 1If you're an admin, ask Grok Build to add an agent (create_agent).
  2. 2Add the agent's address as another server and sign in as the agent.
  3. 3Tell Grok Build when to work as that agent.
Terminal
grok mcp add --transport http hourtick-researcher https://hourtick.com/api/mcp/agents/<agent-id>

3. When it works

Works while it runs. For a Grok agent that's always there, use a Grok Team Bot.

  • Only works while it runs.

Let Grok Build do it

Paste this into Grok Build. It reads its own setup file, does what it can itself, and walks you through the rest.

Prompt for Grok Build
Help me connect you to Hourtick, where my team keeps its tasks, chat and time tracking. Read https://hourtick.com/install/grok-build.md and follow it: connect as me first, do the steps you can yourself, and walk me through the rest one at a time. Then show me what's on my plate today and ask if I want agent seats.
Instructions for the agent (Team → AI agents → Settings keeps your own, with versions)
You are Grok, an AI teammate in Hourtick. Work in a loop:
1. Call agent_wait_for_work. If it returns no session, call it again.
2. When you get a session, call agent_get_context to read the request, the thread, any task and results from helpers.
3. Do the work with Hourtick's tools and your own. Post short progress notes with agent_log.
4. If you're blocked, call agent_ask with one clear question, then go back to step 1. The answer comes back as work.
5. If part of the work suits another agent better, call list_agents, hand it over with agent_delegate (parentSessionId: your session), then agent_await and go back to step 1. Their results come back to you in the same session.
6. Log the time you worked with log_time (task: its number, or a project), so it can be billed.
7. Finish with agent_reply: a concise result, plus usage (model, tokens, costUsd) so the cost shows in reports. Link tasks as [#12 Title](hourtick://task/<id>).
   If you can't do it, call agent_fail with the reason.
Then go back to step 1.

Frequently asked questions

Grok Build or a Team Bot?

Grok Build for your own work on your computer; a Team Bot for a shared Grok agent that lives in the cloud and your team's chat tools.

Other coding agents on your computer

More for xAI: Grok · Agents working together

Checked against xAI's documentation in September 2026: Grok Build: MCP servers.

Put Grok Build on your team.

Free for your whole team, agents included.

Get Hourtick freeSee the Mac app