feat: rename skill from run-stitch to stitch and restructure menu flow

- Rename skill directories and frontmatter from `run-stitch` to `stitch` for both Claude and Codex, making `/stitch` the unified entry point for install and operation
- Restructure the interactive menu into a shallow question tree with at most three options per step to ensure consistent rendering on Codex's `request_user_input` (which caps at 2–3 choices)
- Split the initial four-option menu into three tiers: start/stop/inspect, then inspect branches to status/parameters/approvals, then approvals branches to approvals/upgrade
- Update skill documentation to clarify the question-driven flow: always ask the operator one question at a time instead of inferring actions from vague requests
- Add installation-check logic: confirm installation intent with a single question before showing the menu, or skip directly to the menu if already installed
- Restructure README quick start to lead with the skill installation (recommended for Claude Code and Codex), with the raw prompt as a fallback for other agents
- Update version to 0.1.38 and monorepo source reference

Author: bnolens

.claude/skills/run-stitch/SKILL.md .claude/skills/stitch/SKILL.md.claude/skills/run-stitch/SKILL.md renamed to .claude/skills/stitch/SKILL.md

@@ -1,13 +1,56 @@
 ---
-name: run-stitch
+name: stitch
 description: Operate Stitch, the Textile operator bot — start, stop, restart, check status, tail logs, upgrade, change pool parameters (spreads, liquidity), and manage Permit2 approvals. Falls back to install if Stitch isn't set up yet. Use when asked to "start/stop/restart stitch", "run the bot", "check the bot", "stitch logs", "upgrade stitch", "change the spread/liquidity", or "install stitch".
 ---
 
 # Operate Stitch
 
 Stitch is the Textile operator bot (binary `stitch`): per-pool market making plus
-settlement closing. This skill is for running and tending a Stitch that's already
-installed. If it isn't installed yet, jump to [Not installed yet](#not-installed-yet).
+settlement closing. This skill both runs an existing Stitch and installs one that
+isn't set up yet.
+
+## Always start here
+
+1. **Find the run layout and whether it's installed** — the next section.
+2. **If it's not installed**, don't show the menu. Tell the operator, then with a
+   single `AskUserQuestion` confirm they want to install now. On yes, install by
+   reading `AI_INSTALL_PROMPT.md` and following it in full — see
+   [Not installed yet](#not-installed-yet).
+3. **If it's installed**, ask the operator what they want to do with
+   `AskUserQuestion`, **one question at a time**. Never guess the action from a
+   vague request — ask. Wait for each answer before the next question or any
+   command.
+
+Question-tool rules (same as the install prompt): one question per call, multiple
+choice, most-likely option first, and the tool always adds a free-form answer so
+the operator can type something else. In Codex use `request_user_input` (Plan
+mode); if no question tool is available, ask the same thing in chat, still one at
+a time.
+
+**The menu** — keep every `AskUserQuestion` to **at most three options**,
+most-likely first (so the same flow also renders on Codex's `request_user_input`,
+which caps at 2–3). The tool always adds a free-form answer, so the operator can
+type anything else.
+
+First question — "What do you want to do with Stitch?":
+
+- **Start / resume live** → [Start](#start) (cloud: [AWS cloud](#aws-cloud-ecs-fargate))
+- **Stop / pause** → [Stop](#stop)
+- **Inspect or change it** — status/logs, parameters, approvals, or upgrade
+
+If they pick **Inspect or change it**, ask a second `AskUserQuestion`:
+
+- **Status and logs** → [Status and logs](#status-and-logs)
+- **Change parameters** → [Change parameters](#change-parameters)
+- **Approvals or upgrade**
+
+If they pick **Approvals or upgrade**, ask a third:
+
+- **Run Permit2 approvals** → [Permit2 approvals](#permit2-approvals)
+- **Upgrade** → [Upgrade](#upgrade)
+
+Then carry out the chosen action from the matching section, against the layout you
+detected, honoring the golden rules throughout.
 
 ## First: find the install and how it runs
 

.codex/skills/run-stitch/SKILL.md .codex/skills/stitch/SKILL.md.codex/skills/run-stitch/SKILL.md renamed to .codex/skills/stitch/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: run-stitch
+name: stitch
 description: Operate Stitch, the Textile operator bot — start, stop, restart, check status, tail logs, upgrade, change pool parameters (spreads, liquidity), and manage Permit2 approvals. Falls back to install if Stitch isn't set up yet. Use when asked to "start/stop/restart stitch", "run the bot", "check the bot", "stitch logs", "upgrade stitch", "change the spread/liquidity", or "install stitch".
 metadata:
   short-description: Operate the Stitch operator bot
@@ -8,8 +8,49 @@ metadata:
 # Operate Stitch
 
 Stitch is the Textile operator bot (binary `stitch`): per-pool market making plus
-settlement closing. This skill is for running and tending a Stitch that's already
-installed. If it isn't installed yet, jump to [Not installed yet](#not-installed-yet).
+settlement closing. This skill both runs an existing Stitch and installs one that
+isn't set up yet.
+
+## Always start here
+
+1. **Find the run layout and whether it's installed** — the next section.
+2. **If it's not installed**, don't show the menu. Tell the operator, then with a
+   single question confirm they want to install now. On yes, install by reading
+   `AI_INSTALL_PROMPT.md` and following it in full — see
+   [Not installed yet](#not-installed-yet).
+3. **If it's installed**, ask the operator what they want to do, **one question at
+   a time**. Never guess the action from a vague request — ask. Wait for each
+   answer before the next question or any command.
+
+Question-tool rules (same as the install prompt): use `request_user_input` in Plan
+mode — one question per call, multiple choice, most-likely option first; it adds a
+free-form answer so the operator can type something else. If it isn't available
+(Default mode), ask the same thing in chat, still one at a time.
+
+**The menu** — keep every question to **at most three options**, most-likely
+first (`request_user_input` caps at 2–3, and the install prompt warns more can
+fail to render or fall back to chat). The tool always adds a free-form answer, so
+the operator can type anything else.
+
+First question — "What do you want to do with Stitch?":
+
+- **Start / resume live** → [Start](#start) (cloud: [AWS cloud](#aws-cloud-ecs-fargate))
+- **Stop / pause** → [Stop](#stop)
+- **Inspect or change it** — status/logs, parameters, approvals, or upgrade
+
+If they pick **Inspect or change it**, ask a second question:
+
+- **Status and logs** → [Status and logs](#status-and-logs)
+- **Change parameters** → [Change parameters](#change-parameters)
+- **Approvals or upgrade**
+
+If they pick **Approvals or upgrade**, ask a third:
+
+- **Run Permit2 approvals** → [Permit2 approvals](#permit2-approvals)
+- **Upgrade** → [Upgrade](#upgrade)
+
+Then carry out the chosen action from the matching section, against the layout you
+detected, honoring the golden rules throughout.
 
 ## First: find the install and how it runs
 

.textile-monorepo-source

@@ -1 +1 @@
-5a1f4432525a7c5eff8d9c4228ce776599b5bcbd
+810786baa260dfa725947db9fce9f663ac6617c6

.textile-stitch-release-version

@@ -1 +1 @@
-0.1.37
+0.1.38

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "stitch-bot"
-version = "0.1.37"
+version = "0.1.38"
 edition = "2021"
 description = "Stitch — Textile filler-network operator bot; signs UniswapX limit orders and closes settlement auctions."
 license = "AGPL-3.0-or-later"

Cargo.toml

@@ -31,11 +31,37 @@ Stitch does two jobs for each configured pool by default:
 
 ## Quick Start
 
-The recommended way to install Stitch is to have an AI assistant guide the
-setup, collect the required operator settings, create the config, run a dry run,
-and only start live operation after you confirm.
+The recommended way to install and run Stitch is with an AI coding agent: it
+collects the operator settings, writes the config, runs a dry run, and starts
+live only after you confirm.
 
-Use this short prompt to begin:
+### Claude Code or Codex (recommended)
+
+Install the `stitch` skill once, then just talk to your agent. The skill installs
+Stitch when it's missing and runs it after — start, stop, logs, parameter
+changes, upgrades. Ask your agent to install it:
+
+- **Claude Code** — paste:
+
+  > Install this skill into `~/.claude/skills/stitch/SKILL.md`:
+  > https://raw.githubusercontent.com/textile-protocol/textile-stitch/main/.claude/skills/stitch/SKILL.md
+
+  Then run `/stitch`.
+
+- **Codex** — paste:
+
+  > Install the stitch skill from
+  > https://github.com/textile-protocol/textile-stitch/tree/main/.codex/skills/stitch
+
+  Codex's skill-installer drops it under `~/.codex/skills`. Restart Codex, then
+  ask it to run or install Stitch and it picks up the skill.
+
+With the repo checked out, Claude Code finds the skill automatically.
+
+### Any other agent
+
+No skill support? Paste this prompt into Claude, GPT, Gemini, or any agent with
+terminal access to the machine where Stitch should run:
 
 ```text
 Help me install and configure Textile Stitch.
@@ -50,27 +76,6 @@ STITCH_PRIVATE_KEY, run a dry run first, and do not start live operation until I
 confirm.
 ```
 
-On Claude Code or Codex? Install the `run-stitch` skill once and skip the prompt
-above next time. It guides install when Stitch isn't set up, and otherwise helps
-you run it — start, stop, logs, upgrades, parameter changes. No checkout needed,
-each is a single file in your user config:
-
-```bash
-# Claude Code
-mkdir -p ~/.claude/skills/run-stitch
-curl -fsSL https://raw.githubusercontent.com/textile-protocol/textile-stitch/main/.claude/skills/run-stitch/SKILL.md \
-  -o ~/.claude/skills/run-stitch/SKILL.md
-
-# Codex (skills live under ~/.codex/skills; restart Codex after installing)
-mkdir -p ~/.codex/skills/run-stitch
-curl -fsSL https://raw.githubusercontent.com/textile-protocol/textile-stitch/main/.codex/skills/run-stitch/SKILL.md \
-  -o ~/.codex/skills/run-stitch/SKILL.md
-```
-
-In Claude Code, run `/run-stitch`. In Codex, restart it, then just ask to run or
-install Stitch and it picks up the skill. (With the repo checked out, Claude Code
-finds the skill automatically.)
-
 For the full copyable prompt, open [AI_INSTALL_PROMPT.md](AI_INSTALL_PROMPT.md).
 For configuration reference, tuning, and troubleshooting, see
 [ADVANCED.md](ADVANCED.md).