Skip to content
Source
Sign inSign up

Set up from a terminal

Get started

Set up your agents from a terminal

You install src from a terminal, and you want your coding agents set up in the same go. The install script offers the setup, and src agent setup runs it again at any time.

2 min read

You need:

  • Node.js 22 or later.

1. Run the install command

These are the commands of the macOS / Linux and Windows tabs on the home page. They install src.

On macOS, Linux, or Git Bash on Windows:

curl -fsSL https://gitflare.t-zlak97.workers.dev/install | sh

In Windows PowerShell:

irm https://gitflare.t-zlak97.workers.dev/install.ps1 | iex

2. Say yes to the setup

In a terminal, the script then shows what the setup will change, and asks:

src agent setup would make these changes:
  Write the source skill to ~/.agents/skills/source
  Link ~/.claude/skills/source, for Claude Code
  Add the TanStack Source instructions to ~/.claude/CLAUDE.md, for Claude Code
  Add the TanStack Source instructions to ~/.codex/AGENTS.md, for Codex
  Add the workspace hooks (WorktreeCreate, WorktreeRemove) to ~/.claude/settings.json, for Claude Code
  Register the tanstack-source:// link handler
Set up your coding agents now? [Y/n]

Press Enter to set them up.

Note

When an agent runs the script, there is no terminal to ask in. Then the script only prints the command.

3. Log in and run the setup again

The setup installs the transcript upload hooks only when you are logged in. Log in, then run the setup again. It lists the hooks it will add and asks Make these changes?. Press Enter to add them:

src auth login
src agent setup

Done

Your coding agents have the TanStack Source skill, the instructions to use src, and the transcript upload hooks. What the setup changes lists each file that the setup writes.

Run the setup at any time

--dry-run shows the changes. Then run the setup. In a terminal, it asks before it adds something new. --yes adds it with no question:

src agent setup --dry-run
src agent setup

To update or remove the setup, see Later: update or remove.