skills.rest
sandgardenhq
sandgardenhqOFFICIAL
Explore all skills by this author →
GitHub

workspace-management

Create, fork, delete, and rename sgai workspaces via HTTP API.

130|8|Updated Jan 23, 2026
Search Tags:#api#workspace#http#management#fork#sgai
One-click install
npx skills add https://github.com/sandgardenhq/sgai --skill workspace-management-sandgardenhq
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: workspace-management
Source: https://github.com/sandgardenhq/sgai/tree/main/docs/sgai-skills/workspace-management
Command: npx skills add https://github.com/sandgardenhq/sgai --skill workspace-management-sandgardenhq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing sgai workspaces manually is error‑prone and time‑consuming, especially when creating, forking, deleting, or renaming them across multiple projects.

Core Features & Use Cases

  • Create Workspace: Provision a new standalone workspace via POST /api/v1/workspaces.
  • Fork Workspace: Generate a fork for parallel development using POST /api/v1/workspaces/{name}/fork.
  • Delete Fork: Safely remove a fork with confirmation through POST /api/v1/workspaces/{name}/delete-fork.
  • Rename Fork: Change a fork’s name while preserving its history via POST /api/v1/workspaces/{name}/rename.
  • Additional Controls: Pin workspaces, update summaries, and retrieve GOAL.md or diffs.

Quick Start

Ask the workspace-management skill to create a new workspace named “my-project”.

Frequently Asked Questions about workspace-management

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

FAQPage Schema
How do I create a new sgai workspace through an HTTP API?▼

You create a new sgai workspace by sending a POST request to /api/v1/workspaces with a chosen name. The name must use only lowercase letters, numbers, and dashes for successful provisioning.

What's the best way to fork an existing workspace for parallel development?▼

The best way to fork a workspace for parallel development is by sending a POST request to the /api/v1/workspaces/{name}/fork endpoint, which generates a copy for concurrent work.

Do I need a running sgai server to manage workspaces via API?▼

Yes, you need a running sgai server to manage workspaces via API. The HTTP endpoints for creating, forking, deleting, and renaming workspaces require an active server connection to process requests.

How does deleting a forked workspace work through the API?▼

Deleting a forked workspace works by sending a POST request to /api/v1/workspaces/{name}/delete-fork. This safely removes the fork with confirmation to clean up finished parallel development branches.

Can I rename a forked workspace while preserving its history?▼

Yes, you can rename a forked workspace while preserving its history by sending a POST request to the /api/v1/workspaces/{name}/rename endpoint with the new desired name.

What character restrictions apply when naming a new workspace?▼

When naming a new workspace, character restrictions require using only lowercase letters, numbers, and dashes. Names with uppercase letters, spaces, or special characters will not be accepted by the API.

Related Skills

Explore More Software Engineering Skills→
sandgardenhqsandgardenhq
130

monitoring

Monitor sgai workspaces and agent activity via HTTP and SSE endpoints.

Official
Basic
ucirelloucirello
2

workspace-management

Manage Sgai workspaces and forks via a RESTful API.

Community
Intermediate
haJ1thaJ1t

mcp-api-tester

Automate API testing for MCP endpoints with OpenAPI contract validation.

Community
Advanced
sandgardenhqsandgardenhq
130

session-control

Start, stop, and steer AI agent sessions in sgai workspaces.

Official
Intermediate