Summary

DOT Studio provides a Figma-style local visual editor for designing and choreographing AI agents, specifically performers and acts, built upon the OpenCode execution engine. It targets engineers and researchers working with complex agent systems, offering an intuitive interface that combines direct visual manipulation with AI-assisted authoring to streamline the development of collaborative AI workflows.

How It Works

The core approach centers on a visual canvas where users arrange and connect AI components. It defines four key building blocks: Tal (identity/behavior layer), Dance (reusable skill packages), Performer (runnable agents composed from Tal, Dances, and models), and Act (multi-performer workflows with runtime collaboration rules). Users can author these components directly or leverage the integrated "Studio Assistant" for AI-driven scaffolding and updates. The system emphasizes local, iterative development, saving workspace state, and generating runtime configurations for OpenCode. The mental model is that a Performer is built from Tal, Dance, models, and tools, while an Act orchestrates multiple Performers through defined relationships and rules.

Quick Start & Requirements

Installation is performed globally via npm: npm install -g dot-studio. To run, execute dot-studio /path/to/project. Key requirements include Node.js version 20.19.0 or higher and a compatible environment for Node.js and OpenCode. DOT Studio manages local ports for its client (43100), API (43101), and a managed OpenCode sidecar (43102). The tool can either start an OpenCode instance or connect to an existing one.

Highlighted Details

• Figma-style visual workspace for AI agent choreography.
• Hybrid editing approach: direct manipulation and AI-assisted "Studio Assistant".
• Local-first development environment with workspace state persistence.
• Comprehensive Command Line Interface (CLI) for managing projects, opening specific components, and diagnosing issues (dot-studio doctor).
• Clear distinction between the visual authoring canvas and the runtime execution generated for OpenCode.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or project health signals were present in the provided README content.

Licensing & Compatibility

The provided README text does not specify the software license, nor does it offer compatibility notes for commercial use or integration with closed-source projects.

Limitations & Caveats

The .opencode/ directory contains generated output and should not be directly edited. Edits that affect runtime behavior are applied upon the next execution cycle, with Studio managing the projection and refresh process.