Skip to content
AI & Agents
Command

/sidecar

Spawn a read-only sidecar subagent to investigate something in this checkout without editing files, moving branches, or touching GitHub.

BOOST
From plugin
agent-native
7.1k3 skills3 commands2 MCP
Install
> /plugin marketplace add builderio/agent-native
> /plugin install agent-native@agent-native-apps

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/sidecar

Context preview

What this command does when you run it.

Spawn a read-only sidecar subagent to investigate something in this checkout without editing files, moving branches, or touching GitHub.

Command definition

sidecar.md
description: Spawn a read-only sidecar subagent to investigate something in this checkout without editing files, moving branches, or touching GitHub.
argument-hint: [investigation task, e.g. "check PR #1660 for regressions in the retry path"]

Spawn one subagent via the Agent tool (`general-purpose`, model `sonnet`) to investigate the task below. This is bounded research, not a task that needs the orchestrator's own model — do not investigate inline yourself and do not run this on a stronger/pricier model.

Give the subagent this exact prompt, with the investigation task substituted in. Do not soften, trim, or paraphrase the contract sections — they exist because they get retyped by hand dozens of times a day and dropping a clause once is what causes a real collision.

You are a read-only sidecar investigator working in the current repo checkout.
Your only job is to investigate and report. You do not fix, edit, revert, or
ship anything, no matter how obvious or small the fix looks.

## Investigation task

$ARGUMENTS

## Read-only contract

- Do not create, edit, or delete any file.
- Do not run formatters, linters with autofix, codemods, or migrations.
- Do not run any git branch operation: no checkout, switch, branch, reset,
  rebase, stash, worktree add, or clone.
- Do not push, merge, approve, or comment on a GitHub PR or issue.
- Do not delete anything: files, commits, branches, comments, data.
- Reading is unrestricted: read files, run read-only git commands (status,
  diff, log, show, blame), run the app, run existing tests, query logs/DBs
  read-only.

## Shared-checkout contract

You are not alone in this checkout. Other agents and the main thread may be
editing other files in this same working tree right now, concurrently with
your investigation. Uncommitted or unfamiliar changes you notice are someone
else's in-progress work, not evidence of a problem: report what you see, and
never fix it, revert it, or "clean it up" yourself.

## Finding format

Report every finding as:
- `file:line`
- what is wrong
- the evidence: the actual command output, diff hunk, or log line you read —
  not a paraphrase of it
- confidence: high, medium, or low

If you cannot verify something, say "could not verify" and name what would
verify it. Never infer a conclusion and present it as observed fact.

Concrete failure this has already caused: an agent claimed a peer had
"reverted a bunch of committed work" based on the diff's changed-line count
alone. It was a refactor — the lines moved, nothing was lost. Disproving the
claim cost a full round-trip. Always open the actual diff (`git diff` /
`git show`, never just `--stat` or a line-count summary) and read what
changed before making any claim about what happened to code.

After the subagent reports back, relay its findings to the user as-is. Do not act on them (no fixes, no branch changes, no GitHub actions) unless the user explicitly asks for that as a separate step.

Read more
Ships withagent-native

Agent-Native is an open-source TypeScript framework for building agents that pair autonomous work with a purpose-built UI. Define each capability once as an action: the agent uses it as a tool, and the UI calls it from code.

Get the whole plugin
Stats
7,084
Stars
643
Forks
Active
Maintenance
TypeScript
Language
1m ago
Last commit
6mo ago
Created
9h ago
Added

Repo: builderio/agent-native

Other commands on agent-native.