Log in
Dance of Tal maskDOT StudioLocal Workspace

DOT Studio

The primary way to compose, inspect, and run Dance of Tal systems: a local canvas for Performers, Acts, Tal, and Dances backed by OpenCode execution.

$npm install -g dot-studio@latest
$dot-studio .
Open Studio GuideExplore Registry
Canvas

Place Performers and Acts where you can inspect them.

Inspect

See the Tal, Dances, model, MCP, participants, and relations.

Run

Chat with a Performer or run an Act thread through OpenCode.

dot-studio
$ npm install -g dot-studio@latest
$ cd my-project
$ dot-studio .

connected workspace: .dance-of-tal/
canvas: performers + acts
runtime target: OpenCode sidecar
status: ready
Workflow

Start in Studio. Use the CLI when assets are ready.

Studio is where users understand and operate DOT. The CLI supports publishing, GitHub Dance installs, and scripted workflows after the shape is clear.

DOT Studio

Arrange Performers and Acts on a shared canvas, inspect their Tal and Dance dependencies, edit drafts, choose runtime settings, and run the result locally.

Terminal
$ cd my-project
$ dot-studio .

Studio running at localhost:5173
Loaded workspace from .dance-of-tal/

dot CLI

Add GitHub Dance skills, install canonical assets, and publish stable Tal, Performer, or Act packages once the Studio composition is ready to share.

Terminal
$ dot add monarchjuno/sprint-reviewer
$ dot install performer/@acme/agent-presets/sprint
$ dot create --kind act --name incident-response --stage workflows
$ dot publish --kind act --name incident-response --stage workflows
Studio Asset Model

Tal + Dances + model + MCP = Performer. Performers + choreography = Act.

This is the metaphor Studio uses on the canvas: identity, skills, runnable agents, then collaboration rules.

Tal

Identity & Instructions

tal

The markdown layer that defines who the agent is and how it should behave.

kind: talurnpayload.content
Dance

Reusable Skill Package

dance

An agentskills-style SKILL.md bundle that can be reused across performers.

SKILL.mdpayload.namepayload.content
compose
Merge Point
Identity, skills, model, and tools become one runtime agent.
talUrn
danceUrns
model + MCP
Performer

Runnable Agent

performer

A Tal, Dances, model settings, and MCP config projected into an OpenCode agent.

payload.talpayload.dances[]payload.model
gather
Act

Choreography Spec

act

A multi-performer workflow: participant keys, performer refs, relations, and rules.

participantsrelationsactRules
Act Topology
Participant keys wrap performer refs; relations describe handoffs.
participant key
lead
performer/@team/stage/reviewer
participant key
worker
performer/@team/stage/builder
participant key
qa
performer/@team/stage/checker
relation: worker -> lead · subscription: eventTypes: runtime.idle
Tal and Dance stay reusable: Studio can save them as drafts or install them as assets.
Performer is the runnable unit: Studio projects it into OpenCode for chat and execution.
Act stores choreography: participants, relations, shared rules, and optional wake signals.
Install

Install Studio first

Open any project directory as a Studio workspace. If DOT state is missing, Studio prepares `.dance-of-tal/` automatically.

Quick Start

npm

Install Studio directly with npm, then open your project.

Install Studio
$npm install -g dot-studio@latest
Open Studio
$dot-studio .
Quick Start

One-liner

Install DOT Studio with the same flow shown in the Studio README.

macOS / Linux
$curl -fsSL https://danceoftal.com/install.sh | sh
Windows
$powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr https://danceoftal.com/install.ps1 -UseBasicParsing | iex"
After Install
# 1. Install Studio
$ npm install -g dot-studio

# 2. Open Studio in your project
$ cd my-project
$ dot-studio .
Workspace prepared automatically when needed

# 3. Reopen the same workspace later
$ dot-studio .
Restored workspace for the current directory
Studio

Open a workspace and compose the next Act.

Start with DOT Studio, inspect the pieces on the canvas, then publish or explore Registry assets when the composition is ready.

Read Studio DocsExplore RegistryView Source