skills.rest
PeteRichardson
PeteRichardsonCOMMUNITY
Explore all skills by this author →
GitHub

supacode-deeplinks

Control Supacode worktrees, tabs, and repositories via supacode:// deeplink URLs.

Updated Jun 4, 2026
Search Tags:#cli#worktree#macos#terminal automation#deeplinks#url scheme#supacode
One-click install
npx skills add https://github.com/PeteRichardson/skills --skill supacode-deeplinks-peterichardson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: supacode-deeplinks
Source: https://github.com/PeteRichardson/skills/tree/main/supacode-deeplinks
Command: npx skills add https://github.com/PeteRichardson/skills --skill supacode-deeplinks-peterichardson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you automate and control the Supacode terminal app from scripts, other applications, or terminals where the supacode CLI is not installed, using the supacode:// URL scheme instead of manual UI interaction. ## Core Features & Use Cases - Worktree Automation: Select, run, stop, archive, pin, and delete worktrees, and create new worktrees from a repository with branch and base parameters. - Tab & Surface Control: Create, rename, focus, split, and destroy tabs and terminal surfaces, optionally passing input commands. - Repository & Settings Access: Open repositories by path and jump directly to specific settings sections such as scripts or developer options. - Use Case: From a CI script running outside Supacode, dispatch open "supacode://worktree/$SUPACODE_WORKTREE_ID/run" to trigger the primary run script for a worktree without any UI interaction. ## Quick Start Ask the AI to run the primary script for the current Supacode worktree using a supacode:// deeplink dispatched with the open command.

Frequently Asked Questions about supacode-deeplinks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Supacode from a script or terminal?▼

Dispatch a supacode:// deeplink with the open command, for example open "supacode://worktree/$SUPACODE_WORKTREE_ID/run". Prefer the supacode CLI when it is installed, and use deeplinks only where the CLI is unavailable.

How do I find my Supacode worktree and repository IDs?▼

Each Supacode terminal session exposes SUPACODE_REPO_ID, SUPACODE_WORKTREE_ID, SUPACODE_TAB_ID, and SUPACODE_SURFACE_ID as environment variables. Run env | grep SUPACODE_ to discover the IDs for the current session.

Can I archive or delete the worktree I am currently working in?▼

Yes, but it closes your own surface, so commands after the call do not run. Make archiving or deleting your own worktree the final operation after all edits, commits, and reporting are complete.

Why does my supacode deeplink ask for confirmation?▼

Deeplinks that run commands or perform destructive actions require confirmation unless "Allow dangerous actions" is enabled in Developer settings. This protects against unintended destructive operations.

How do I run a deeplink without changing focus in Supacode?▼

Append background=true to any worktree action or repo worktree/new deeplink. This leaves the sidebar selection and keyboard focus untouched, and new tabs or splits stay in the background.

Related Skills

Explore More Software Engineering Skills→
sergicalsergical
1

cmux

Create and manage terminal tabs and splits in cmux workspaces.

Community
Intermediate
purduehackerspurduehackers
4

actions

Manage GitHub Actions workflows, runs, and build artifacts via the GitHub API.

Official
Intermediate
Lento47Lento47
1

codex

Delegates coding tasks to the OpenAI Codex CLI for features, refactoring, and PR reviews.

Community
Intermediate
SolizardkingSolizardking

tmux

Remote-control tmux sessions by sending keystrokes and capturing pane output for interactive CLI orchestration.

Community
Intermediate