Menu
Start and stop agentic sessions in sgai workspaces. Use when you need to launch AI agent sessions or halt running sessions.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Go code review checklist based on official Go style guides. When reviewing Go code for style, idioms, and best practices
Guide for creating custom opencode agents with proper configuration, permissions, path-based delegation, work splitting, and strict status envelopes. Use when creating or updating agents for coordination, implementation, review, deployment, verification, documentation, or specialized workflows.
TDD for process documentation - test with subagents before writing, iterate until bulletproof. When you discover a technique, pattern, or tool worth documenting for reuse. When editing existing skills. When asked to modify skill documentation. When you've written a skill and need to verify it works before deploying. When skills fail to help agents, when documentation is unclear, when new patterns emerge that need standardization.
Create and setup a new OpenAI Agents SDK application with interactive guidance for language choice, agent type selection (Basic, Voice, Realtime), project setup, and automatic verification.
Create and setup a new Claude Agent SDK application with interactive guidance for language choice, project setup, and automatic verification.
Problem-Solving Dispatch; Dispatch to the right problem-solving technique based on how you're stuck; Stuck on a problem. Conventional approaches not working. Need to pick the right problem-solving technique. Not sure which skill applies.
| name | session-control |
| description | Start and stop agentic sessions in sgai workspaces. Use when you need to launch AI agent sessions or halt running sessions. |
| compatibility | Requires a running sgai server with workspaces that have a GOAL.md configured. |
Sessions are the running instances of AI agents working on a workspace. Each workspace can have at most one running session.
Endpoint: POST /api/v1/workspaces/{name}/start
# 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:
{"auto": true}
Response:
{
"name": "my-project",
"status": "running",
"running": true,
"message": "session started"
}
| Mode | auto | Description |
|---|---|---|
| Brainstorming | false | Pauses at key decision points to ask for input |
| Self-drive | true | Runs fully autonomously without interruption |
| Continuous | (auto-detected) | If workspace has a continuous.md prompt, uses continuous mode |
Notes:
"message": "session already running"Endpoint: POST /api/v1/workspaces/{name}/stop
curl -X POST $BASE_URL/api/v1/workspaces/my-project/stop
Response:
{
"name": "my-project",
"status": "stopped",
"running": false,
"message": "session stopped"
}
If already stopped: "message": "session already stopped"
Use the full state endpoint to check session status:
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:
| Field | Type | Description |
|---|---|---|
running | bool | Is session active? |
inProgress | bool | Is work actively happening? |
task | string | Current task description |
status | string | Workflow status string |
latestProgress | string | Most recent progress note |
Open the workspace in OpenCode terminal (localhost connections only).
Endpoint: POST /api/v1/workspaces/{name}/open-opencode
curl -X POST http://localhost:PORT/api/v1/workspaces/my-project/open-opencode
Response:
{
"opened": true,
"message": "opened in opencode"
}
Errors:
403 — remote connections not allowed (localhost only)409 — session not runningOpen the workspace directory in the configured editor (VS Code, etc.).
Endpoint: POST /api/v1/workspaces/{name}/open-editor
curl -X POST $BASE_URL/api/v1/workspaces/my-project/open-editor
Response:
{
"opened": true,
"editor": "code",
"message": "opened in editor"
}
# 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