Hellotracks for AI agents

The best dispatch system for AI agents.

Give your agent a real route solver, live GPS of your whole crew and every job. It plans next week, splits the work, and re-routes the moment something changes. You ask in plain words. Your team sees it in the app a second later.

Paste this into Claude Code, Codex or Cursor

Set up Hellotracks for me. Instructions: hellotracks.com/cli

Free for 30 days. No credit card. Or install it yourself · Open source (MIT)

Your agentClaude Code · Codex · Cursor
live.hellotracks.com
Map of San Francisco with two planned routesYour company's map appears here
Works withClaude CodeCodexCursorAny agent with a shellGitHub Actions and CImacOS · Linux

Routing and dispatch

Your agent becomes the dispatcher you never had time to be.

Hellotracks hands it the same route solver your dashboard uses: working hours, time windows, skills and vehicle capacity, all respected. Plus where everyone is right now, and what's done. With that, an agent can do what used to take a full-time planner.

Plan weeks ahead.

“Plan next week for the whole crew.” The agent puts every job on a day, works out each person's route for each day, and tells you what doesn't fit, before Monday comes.

Your agent runsht jobs sync --file next-week.csv --dry-runht routing optimize --account ana --date 2026-11-09 --solve

Split the work fairly.

“Spread today's 40 jobs across the team.” It looks at who's working, where they start and how full their day is, assigns each job, then lets the solver order every route.

Your agent runsht jobs list --date today --unassignedht jobs update job-482 --assignee-username marcoht routing optimize --account marco --date today --solve

Dispatch live.

“An urgent job just came in. Who can take it?” A van breaks down, a customer cancels, an urgent job comes in at 11. The agent sees where everyone is, moves the jobs and re-plans their routes in seconds.

Your agent runsht members locate <ana> <marco>ht jobs list --assignee-username luis --date today --progress scheduledht routing optimize --account ana --date today --solve

11:12. Luis's van won't start.

That used to be an hour of phone calls. Now it's one sentence to your agent, and both phones update before Luis has finished calling the tow truck.

Luis is stuck. Give his afternoon to whoever's closest.
Your agent runsht jobs list --assignee-username luis --date today --progress scheduledht members locate <ana> <marco>
Luis has 4 jobs left. Ana is 6 minutes from the first two, Marco is nearer the other two. Move them like that?
Yes.
Your agent runsht jobs update job-511 --assignee-username anaht routing optimize --account ana --date today --solveht routing optimize --account marco --date today --solve
Done. Ana and Marco have the new stops on their phones. Everyone still finishes before 6.

Why it's the best

Other dispatch tools give agents an API and wish them luck. Hellotracks gives them the whole job.

It signs itself up.

No form, no password, no key to copy. Your agent runs ht signup, a code goes to your email, you tell your agent the code. A minute later you have a company.

It knows the trade.

ht skills install teaches your agent Hellotracks: what to check first, how to sync without duplicates, when to ask you. It doesn't guess.

It does the real work.

Jobs, routes with time windows and skills, people, places, timesheets, forms, alerts, arrival links, reports. Everything your dispatcher does.

Your crew just works.

Whatever the agent does shows up in the phone app and the dashboard right away. Your team doesn't need to know an agent did it.

What you can ask

Ask for the work, not the commands.

“Put tomorrow's work orders from this sheet into Hellotracks.”

Your agent runsht jobs sync --file orders.csv --upsert-by externalId --dry-run

“Plan Ana's route for Friday. Keep the time windows.”

Your agent runsht routing optimize --account ana --date 2026-11-06 --solve

“Where is Luis right now?”

Your agent runsht members locate <luis>

“Who clocked more than 10 hours a day last week?”

Your agent runsht timesheets export --from 2026-10-26 --until 2026-11-01 --output csv

“Write the 2 pm customer an email with a live arrival link.”

Your agent runsht eta create --job job-123 · ht eta snippet eta_123 --format email

“Tell our CRM every time a job is done.”

Your agent runsht webhooks set --event job_completed --url https://crm.example.com/hooks

Set up

From nothing to dispatching in one conversation.

  1. 01

    Your agent installs ht.

    One line on macOS or Linux. Nothing else to install.

    Your agent runscurl -fsSL https://cli.hellotracks.org/install.sh | bash
  2. 02

    It learns Hellotracks.

    A skill file for Claude Code and Codex: every command, what to check first, what to ask you.

    Your agent runsht skills install
  3. 03

    It signs you up, or logs you in.

    A 6-digit code goes to your email. You tell your agent the code. No password, no key to paste.

    Your agent runsht signup · ht auth login --email
  4. 04

    You ask. It dispatches.

    Jobs land on your crew's phones. Routes are saved. You check the dashboard whenever you like.

    You openlive.hellotracks.com

You stay in charge

Give it the keys. Keep the brakes.

An agent that runs your field work should be easy to trust and easy to stop. That's built in, not bolted on.

It shows you first.
Imports and syncs run as a preview first (--dry-run), and the agent tells you what would change before it writes anything.
Deleting asks.
Every command that removes something asks for a yes. A job you delete stays deleted, even if a sync sends it again.
Keys run out.
A key your agent gets by email code works for 90 days, only for admins, and you can revoke it any time with ht apikeys revoke.
Never the wrong company.
Profiles keep test and live apart. --confirm-profile stops a command aimed at the wrong one.
Nothing hidden.
Every change is a command you can read in your agent's log. The key sits in your Keychain and is never printed.

For engineers

Clear answers, so your agent gets it right.

The API's own objects

--json prints them unchanged. Errors are one JSON line on stderr.

Exit codes that mean something

2 bad key, 4 not found, 6 rate limited, 7 a bulk run with failed rows, 10 server.

Discover, don't guess

ht commands --json lists every command and option. columns and template show every field.

Safe to run twice

Sync by your own ids (--upsert-by externalId). Reads retry; writes never do.

Headless and in CI

--no-input, HELLOTRACKS_API_KEY_FILE, and ht auth login --email --key-file for runners.

Open source, MIT

Read every request it makes, on GitHub.

  • Jobs
  • Routing
  • Members
  • Places
  • Timesheets
  • Forms
  • Alerts
  • Reports
  • ETA pages
  • Maps
  • Webhooks
  • API keys

For your agent

Instructions for your agent

Tell your agent this, in Claude Code, Codex, Cursor or any agent that can run commands. It reads the steps and follows them. Nothing is set up without the code from your email.

Set up Hellotracks for me. Instructions: hellotracks.com/cli

  1. 01 · InstallmacOS or Linux. If ht isn't found afterwards, run ~/.local/bin/ht.curl -fsSL https://cli.hellotracks.org/install.sh | bash
  2. 02 · Learn HellotracksInstalls the Hellotracks skill for Claude Code and Codex. Read it before going on.ht skills install
  3. 03 · Sign up, or log inNew to Hellotracks: sign up with the person's own details. Add --accept-terms only if they said they accept https://hellotracks.com/terms-of-service. Already have an account: log in by email.ht signup --email <email> --name <name> --company <company> --address <address>ht auth login --email <email>
  4. 04 · The codeA 6-digit code goes to their email. Ask them for it; it works for 30 minutes.ht signup --code <code>ht auth login --email <email> --code <code>
  5. 05 · Check, then workCheck which account you are logged in to. Then do what they asked: run imports with --dry-run first and ask before deleting anything.ht auth whoami

Questions

Before you hand it over.

Which agents work?
Any agent that can run commands on a computer: Claude Code, Codex, Cursor, or your own. Chat apps that can't run commands, like ChatGPT in the browser, can't use it yet.
Do I need to be a developer?
No. You need an agent and the words for what you want. The agent types the commands.
Can it do something I can't undo?
Deleting always asks first, and bulk changes show you a preview. If you want a hard stop, revoke its key.
What does my crew need?
The Hellotracks app on their phones. They see jobs and routes like always.

Paste one line. Your agent runs dispatch.

Paste this into Claude Code, Codex or Cursor

Set up Hellotracks for me. Instructions: hellotracks.com/cli

Free for 30 days. No credit card. Command reference · GitHub