Docs / Start / From your coding agent
From your coding agent
MarkdownOpen in ClaudeOpen in ChatGPT
At the end, your coding agent plans a run with you, starts it on your go and brings you every gate, without you leaving the harness you are in.
- Time
2 minutes.
- You need
- On your laptop done
- Claude Code, Codex or pi, open in a Git repository of yours
Set this up with your agent
Copy this to a coding agent on your laptop. It runs the commands and checks each step with you; what you sign in to, press or paste stays yours.
This is for a coding agent that can run commands on my laptop (Claude Code, Codex, Cursor), not a chat website.
Walk me through Loopgate's docs page "From your coding agent": https://loopgate.dev/docs/agent.md. The pages it links to are beside it, each ending in .md.
Run its commands yourself, on my laptop or on my box over SSH as the page says, one step at a time, and check each "You should see" line before the next step.
These are mine: tell me when it is my turn, wait for me, and never ask me to type them into this chat. Signing in to anything (the portal, a cloud console, Slack, GitHub), pressing Add a runner, every token and password, my AI subscription's device code, and making the Slack app.
If I paste you the portal's install line, run it on the box: its token works once, for an hour.Steps
Put the
loopgatecommand on your path.npm install -g loopgateYou should see:
loopgate --versionprint a version.Install the skill.
loopgate skill installYou should see: the four folders it wrote,
~/.agents/skills/loopgatefirst, then the links to it under~/.claude/skills,~/.codex/skillsand~/.pi/agent/skills.In your harness, say what you want run, such as
run plan-build-review on this, Fable plans and Sol builds. Name models you are signed in to.You should see: the workflow drawn in a code block, then the plan: every step's engine, access and pace, the rounds, and the gates you will answer.
Say yes.
You should see: the run's link. It opens the same run in the workbench.
Keep working. The agent waits with
loopgate waitand relays the ask when the run needs you.You should see: the step's reply and the question in your harness, in words.
Answer in your own words: an option's number or name (such as
Open PR), Continue, Lock, yes or no.You should see: the agent run
loopgate decidewith your words, and the run go on.
Good to know
- Your agent uses six commands:
loopgate workflows,plan,run,wait,decideandtell. The commands lists the rest. - A gate is yours. The agent asks you and passes on your answer; it never answers one itself.
- One task is one run. Parallel work is lanes inside it, never several runs.
tellcarries your words to a step verbatim: a reply while it waits, a steer while it works, a note before it runs.loopgate plan … --on <runner>andloopgate run launch.yaml --on <runner>start on your team's runner, in its workspace with the same Git origin.- Nothing costs a token between those moments.
loopgate status <run>and the link show where it is.
If something is off
Codex cannot reach Loopgate. Its sandbox blocks the daemon's socket. Let it run
loopgateescalated, or allow it in~/.codex/config.toml:[sandbox_workspace_write] network_access = trueskill installsays a different skill exists. Another skill sits in one of the four folders. Move it aside and run it again.The plan names another engine than yours. The model you named is not signed in, so a ready one was fitted in its place. Sign in to it, or tell the agent which signed-in model to use.