wisp-new-run

WISP — New Run

Take the user from a freeform goal to a running harness execution.

Platform note: snippets below show both bash and PowerShell forms. Pick the one matching the user's shell. The bash form also runs from Git Bash / WSL on Windows.

Inputs needed (ask the user if missing, do not guess)

• Goal: what should the agents accomplish? (1-2 sentences)
• Repo path: absolute path to the git repo to operate in (must exist + be a git repo)
• Template: one of ts-library | python-backend | refactor-squad | data-pipeline | none
• Project name: short identifier (kebab-case if possible)

Preflight

1. Confirm the harness server is up.

   • bash: curl -s http://127.0.0.1:${WISP_PORT:-4400}/api/health
   • PowerShell: Invoke-RestMethod -Uri "http://127.0.0.1:$($env:WISP_PORT ?? 4400)/api/health"

   If it returns non-200 or refuses connection, tell the user to run /wisp-dashboard first to start the server, then re-run this skill.

2. Confirm the repo path exists and is a git repo: git -C <repoPath> rev-parse --git-dir. If not, ask the user to fix the path or run git init in it.

Steps

1. Create project:

   # bash / Git Bash
   curl -s -X POST http://127.0.0.1:${WISP_PORT:-4400}/api/projects \
     -H 'content-type: application/json' \
     -d '{"name":"<name>","goal":"<goal>","repoPath":"<repoPath>"}'
   

   # PowerShell
   $port = if ($env:WISP_PORT) { $env:WISP_PORT } else { 4400 }
   $body = @{ name = "<name>"; goal = "<goal>"; repoPath = "<repoPath>" } | ConvertTo-Json
   Invoke-RestMethod -Method Post -Uri "http://127.0.0.1:$port/api/projects" `
     -ContentType "application/json" -Body $body
   

   Capture id from the response — this is the projectId.

2. Seed team from template (only if template != none):

   # bash + jq
   TEAM=$(curl -s http://127.0.0.1:${WISP_PORT:-4400}/api/team-templates \
     | jq -c --arg id <template-id> '.templates[] | select(.id==$id) | .team')
   curl -s -X PUT http://127.0.0.1:${WISP_PORT:-4400}/api/projects/<projectId>/team \
     -H 'content-type: application/json' \
     -d "$TEAM"
   

   # PowerShell (no jq needed — ConvertFrom-Json gives objects)
   $port = if ($env:WISP_PORT) { $env:WISP_PORT } else { 4400 }
   $tpl = Invoke-RestMethod -Uri "http://127.0.0.1:$port/api/team-templates"
   $team = ($tpl.templates | Where-Object { $_.id -eq "<template-id>" }).team
   Invoke-RestMethod -Method Put -Uri "http://127.0.0.1:$port/api/projects/<projectId>/team" `
     -ContentType "application/json" -Body ($team | ConvertTo-Json -Depth 20)
   

   If neither jq nor PowerShell is available, fetch the templates response into a Python or Node one-liner that prints just .team for the chosen id, then pipe that into the PUT body. Do NOT use --data-binary @<file> unless you've actually written the file first. If template == none: tell the user to open the dashboard and configure the team manually, then exit this skill (you cannot create a default team via API today — the dashboard handles defaults).