sculpt-cli

Manage workspaces and orchestrate agents via the sculpt CLI.

213|13|Updated Aug 7, 2025
One-click install
npx skills add https://github.com/imbue-ai/sculptor --skill sculpt-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sculpt-cli
Source: https://github.com/imbue-ai/sculptor/tree/main/sculptor/sculptor-plugin/skills/sculpt-cli
Command: npx skills add https://github.com/imbue-ai/sculptor --skill sculpt-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires SCULPT_API_PORT, Sculptor platform, and includes scripts (resource) components.

What problem does it solve?

The sculpt-cli skill provides a command-line interface to interact with the Sculptor platform programmatically, offering greater control and integration possibilities for automation.

Core Features & Use Cases

  • API Interaction: Utilizes a CLI to communicate with the Sculptor API for tasks such as managing agents, creating and manipulating workspaces, and more.
  • Agent Orchestration: Core support for delegate-and-await patterns and handling agents across multiple workspaces.
  • Integration and Custom Workflows: Facilitates the integration of Sculptor into external workflows and scripts for enhanced productivity.

Quick Start

Use the sculpt command with the appropriate flags to interact with Sculptor's features and functionalities. For instance, to create a workspace and an agent: sculpt run --model opus --name "New workspace" "Setup the new project".

Frequently Asked Questions about sculpt-cli

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

FAQPage Schema
How do I automate workspace management in Sculptor?

To automate workspace management in Sculptor, use the sculpt CLI tool to programmatically create and manipulate workspaces via the Sculptor REST API. This enables direct integration into external scripts and custom workflows for enhanced automation productivity.

Can I orchestrate multiple agents across different workspaces from the command line?

Yes, you can orchestrate multiple agents across different workspaces from the command line using the sculpt CLI. It supports delegate-and-await patterns and handles agent manipulation, allowing you to manage complex agent interactions within the Sculptor ecosystem.

Do I need a specific API port configured to use the sculpt CLI?

Yes, you need the SCULPT_API_PORT environment variable configured to use the sculpt CLI. This environment variable integration is required alongside the Sculptor platform to establish proper API interaction and CLI tooling functionality.

What is the best way to integrate Sculptor into existing automation scripts?

The best way to integrate Sculptor into existing automation scripts is by using the sculpt CLI. It provides a command-line interface to communicate directly with the Sculptor API, facilitating seamless workflow integration for tasks like creating workspaces and managing agents.

How does the delegate-and-await pattern work for agent orchestration?

The delegate-and-await pattern for agent orchestration works by allowing the sculpt CLI to delegate tasks to agents and wait for their completion. This mechanism facilitates structured agent manipulation and orchestration across multiple workspaces within the Sculptor platform.

Are there limitations when using CLI tooling for Sculptor API interaction?

Limitations when using CLI tooling for Sculptor API interaction include the absolute dependency on the Sculptor platform and proper SCULPT_API_PORT configuration. Without these environment prerequisites, the sculpt CLI cannot execute workspace manipulation or agent management commands.