rogee/superpowers
1
0
Fork 0
mirror of https://github.com/obra/superpowers.git synced 2026-06-12 13:49:05 +08:00
Code Issues Packages Projects Releases Wiki Activity

Revert "Make visual-companion.md script paths skill-rooted, not plugin-rooted"

Browse Source 
This reverts commit e9f5188289.
This commit is contained in:
Jesse Vincent
2026-05-23 17:01:46 -07:00
parent d48bec6cc3
commit 8811b0f2d7
1 changed files with 9 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
skills/brainstorming/visual-companion.md
View File

@@ -34,7 +34,7 @@ The server watches a directory for HTML files and serves the newest one to the b
```bash ```bash
# Start server with persistence (mockups saved to project) # Start server with persistence (mockups saved to project)
skills/brainstorming/scripts/start-server.sh --project-dir /path/to/project scripts/start-server.sh --project-dir /path/to/project
# Returns: {"type":"server-started","port":52341,"url":"http://localhost:52341", # Returns: {"type":"server-started","port":52341,"url":"http://localhost:52341",
# "screen_dir":"/path/to/project/.superpowers/brainstorm/12345-1706000000/content", # "screen_dir":"/path/to/project/.superpowers/brainstorm/12345-1706000000/content",
@@ -52,7 +52,7 @@ Save `screen_dir` and `state_dir` from the response. Tell user to open the URL.
**Claude Code:** **Claude Code:**
```bash ```bash
# Default mode works — the script backgrounds the server itself. # Default mode works — the script backgrounds the server itself.
skills/brainstorming/scripts/start-server.sh --project-dir /path/to/project scripts/start-server.sh --project-dir /path/to/project
``` ```
On Windows, the script auto-detects and switches to foreground mode (which blocks the tool call). Use `run_in_background: true` on the Bash tool call so the server survives across conversation turns, then read `$STATE_DIR/server-info` on the next turn to get the URL and port. On Windows, the script auto-detects and switches to foreground mode (which blocks the tool call). Use `run_in_background: true` on the Bash tool call so the server survives across conversation turns, then read `$STATE_DIR/server-info` on the next turn to get the URL and port.
@@ -61,14 +61,14 @@ On Windows, the script auto-detects and switches to foreground mode (which block
```bash ```bash
# Codex reaps background processes. The script auto-detects CODEX_CI and # Codex reaps background processes. The script auto-detects CODEX_CI and
# switches to foreground mode. Run it normally — no extra flags needed. # switches to foreground mode. Run it normally — no extra flags needed.
skills/brainstorming/scripts/start-server.sh --project-dir /path/to/project scripts/start-server.sh --project-dir /path/to/project
``` ```
**Gemini CLI:** **Gemini CLI:**
```bash ```bash
# Use --foreground and set is_background: true on your shell tool call # Use --foreground and set is_background: true on your shell tool call
# so the process survives across turns # so the process survives across turns
skills/brainstorming/scripts/start-server.sh --project-dir /path/to/project --foreground scripts/start-server.sh --project-dir /path/to/project --foreground
``` ```
**Copilot CLI:** **Copilot CLI:**
@@ -76,7 +76,7 @@ skills/brainstorming/scripts/start-server.sh --project-dir /path/to/project --fo
# Use --foreground and start the server via the bash tool with mode: "async" # Use --foreground and start the server via the bash tool with mode: "async"
# so the process survives across turns. Capture the returned shellId for # so the process survives across turns. Capture the returned shellId for
# read_bash / stop_bash if you need to interact with it later. # read_bash / stop_bash if you need to interact with it later.
skills/brainstorming/scripts/start-server.sh --project-dir /path/to/project --foreground scripts/start-server.sh --project-dir /path/to/project --foreground
``` ```
**Other environments:** The server must keep running in the background across conversation turns. If your environment reaps detached processes, use `--foreground` and launch the command with your platform's background execution mechanism. **Other environments:** The server must keep running in the background across conversation turns. If your environment reaps detached processes, use `--foreground` and launch the command with your platform's background execution mechanism.
@@ -84,7 +84,7 @@ skills/brainstorming/scripts/start-server.sh --project-dir /path/to/project --fo
If the URL is unreachable from your browser (common in remote/containerized setups), bind a non-loopback host: If the URL is unreachable from your browser (common in remote/containerized setups), bind a non-loopback host:
```bash ```bash
skills/brainstorming/scripts/start-server.sh \ scripts/start-server.sh \
--project-dir /path/to/project \ --project-dir /path/to/project \
--host 0.0.0.0 \ --host 0.0.0.0 \
--url-host localhost --url-host localhost
@@ -277,12 +277,12 @@ If `$STATE_DIR/events` doesn't exist, the user didn't interact with the browser
## Cleaning Up ## Cleaning Up
```bash ```bash
skills/brainstorming/scripts/stop-server.sh $SESSION_DIR scripts/stop-server.sh $SESSION_DIR
``` ```
If the session used `--project-dir`, mockup files persist in `.superpowers/brainstorm/` for later reference. Only `/tmp` sessions get deleted on stop. If the session used `--project-dir`, mockup files persist in `.superpowers/brainstorm/` for later reference. Only `/tmp` sessions get deleted on stop.
## Reference ## Reference
- Frame template (CSS reference): `skills/brainstorming/scripts/frame-template.html` - Frame template (CSS reference): `scripts/frame-template.html`
- Helper script (client-side): `skills/brainstorming/scripts/helper.js` - Helper script (client-side): `scripts/helper.js`