sandgardenhq/sgai/session-control

Claude Code and agent skill by sandgardenhq/sgai

Trust tier 2
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Start and stop agentic sessions in sgai workspaces. Use when you need to launch AI agent sessions or halt running sessions.

Install

npx vskill@latest install sandgardenhq/sgai/session-control

SKILL.md

Session Control

Sessions are the running instances of AI agents working on a workspace. Each workspace can have at most one running session.

Start a Session

Endpoint: POST /api/v1/workspaces/{name}/start

bash
# Brainstorming mode (interactive, pauses for human input)
curl -X POST $BASE_URL/api/v1/workspaces/my-project/start \
  -H "Content-Type: application/json" \
  -d '{"auto": false}'
 
# Self-drive mode (fully autonomous, no pausing)
curl -X POST $BASE_URL/api/v1/workspaces/my-project/start \
  -H "Content-Type: application/json" \
  -d '{"auto": true}'

Request:

json
{"auto": true}

Response:

json
{
  "name": "my-project",
  "status": "running",
  "running": true,
  "message": "session started"
}
Session Modes
ModeautoDescription
BrainstormingfalsePauses at key decision points to ask for input
Self-drivetrueRuns fully autonomously without interruption
Continuous(auto-detected)If workspace has a continuous.md prompt, uses continuous mode

Notes:

  • Root workspaces cannot start agentic work (only forks/standalone can)
  • If already running, returns "message": "session already running"

Stop a Session

Endpoint: POST /api/v1/workspaces/{name}/stop

bash
curl -X POST $BASE_URL/api/v1/workspaces/my-project/stop

Response:

json
{
  "name": "my-project",
  "status": "stopped",
  "running": false,
  "message": "session stopped"
}

If already stopped: "message": "session already stopped"

Check Running Status

Use the full state endpoint to check session status:

bash
STATE=$(curl -s $BASE_URL/api/v1/state)
RUNNING=$(echo $STATE | jq '.workspaces[] | select(.name=="my-project") | .running')
TASK=$(echo $STATE | jq -r '.workspaces[] | select(.name=="my-project") | .task')

Key workspace state fields for session monitoring:

FieldTypeDescription
runningboolIs session active?
inProgressboolIs work actively happening?
taskstringCurrent task description
statusstringWorkflow status string
latestProgressstringMost recent progress note

Open in OpenCode (Local Only)

Open the workspace in OpenCode terminal (localhost connections only).

Endpoint: POST /api/v1/workspaces/{name}/open-opencode

bash
curl -X POST http://localhost:PORT/api/v1/workspaces/my-project/open-opencode

Response:

json
{
  "opened": true,
  "message": "opened in opencode"
}

Errors:

  • 403 — remote connections not allowed (localhost only)
  • 409 — session not running

Open in Editor

Open the workspace directory in the configured editor (VS Code, etc.).

Endpoint: POST /api/v1/workspaces/{name}/open-editor

bash
curl -X POST $BASE_URL/api/v1/workspaces/my-project/open-editor

Response:

json
{
  "opened": true,
  "editor": "code",
  "message": "opened in editor"
}
Open Specific Files
bash
# Open GOAL.md in editor
curl -X POST $BASE_URL/api/v1/workspaces/my-project/open-editor/goal
 
# Open PROJECT_MANAGEMENT.md in editor
curl -X POST $BASE_URL/api/v1/workspaces/my-project/open-editor/project-management

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
124
Repository forks
7
7-day trend score
24

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 27 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/sandgardenhq/sgai/session-control/badge)](https://verified-skill.com/skills/sandgardenhq/sgai/session-control)

Something wrong with this skill or its page? Tell us.