# Install outsrc

Good work takes a team. outsrc is a Grok Bot that hands coding tasks to Claude Code, Codex or Grok Build on your machine. Each job runs in its own git worktree, and results come back to an inbox.

## Install

**Install Outsrc bot** from Bot Exchange. That's the whole install: the bot walks you through the rest on your computer. Listing: https://x.ai/bot/FdogFaBe5Y2LWMc-bmsAg There is no payment step.

outsrc is open source: https://github.com/proticom/outsrc.ing

## Tips

- **Route work by talking.** Tell Outsrc which work goes to Claude, Codex or Grok, and how hard to try: "send refactors to Claude" or "reviews to Codex at high effort." It remembers and uses that on later jobs. There are no settings to edit.
- **It notices habits.** If you keep sending the same kind of work to the same agent the same way, Outsrc may ask once whether to make that the default.
- **Watch jobs live.** `outsrc streams` (or `watch`) opens a browser grid showing each agent's live log tail, served from your own computer (127.0.0.1). Ctrl-C leaves jobs running.
- **Track usage and spend.** When a run finishes, `outsrc usage` reports tokens in and out, estimated cost when the vendor provides it, and wall minutes. Local only — it reads your computer, not a cloud dashboard.
- **Check for updates.** `outsrc updates` (or `updates refresh`) checks whether Claude Code, Codex, Grok Build and outsrc are behind their latest release. The bot asks before upgrading. Nothing is installed until you say yes.
- **Doctor reports version status.** `outsrc doctor --json` includes `update_available` and `version.{status,installed,latest}` where status is `current`, `outdated`, `ahead` or `unknown`. Doctor checks; it never upgrades.
- **Model lists are cached.** Vendor model lists live in `~/.outsrc/models.json`. `outsrc models` shows it; `models refresh` or `list_targets --refresh` updates it. `send` refuses an unknown model when the cache has a list for that target.

## What the bot knows

The Exchange bot comes with five built-in skills:

- **getting-started** — walks you through install and first setup
- **outsrc-dispatch (dispatch)** — starts a job with `send`, polls the inbox, shows streams and usage reports
- **outsrc-upgrade (upgrade)** — checks for CLI updates and handles the upgrade handshake when you agree
- **outsrc-failures (failures)** — diagnoses common failures and suggests fixes
- **outsrc-add-machine (add-machine)** — sets up outsrc on a second computer

## More than one computer

Open Grok Bot on each computer you want to use, then ask Outsrc to set that computer up. Each computer keeps its own list of repositories agents may work in.

## Security (short)

outsrc is not a sandbox. You choose which repositories agents may touch. Jobs run as you, in fresh worktrees, on your machine. Details: https://outsrc.ing/security.md

## Running it yourself

Bot authors and advanced users can run the harness directly. See **Running the harness yourself** in the repository README.