Documentation

Getting started

Install Graffitty, open a session, and arrange your workspace.

Download the app

Choose the package for your platform from the latest GitHub release. Follow the installation instructions included with that release.

Open GitHub Releases ↗

Arrange your panes

Use Split right or Split down to put a terminal beside the current pane. New panes tile inside the main area; drag a shared border to resize them. Zoom out to see panes stashed outside the main area.

Workspace documentation →

Create and return to a session

Use the Sessions menu or the CLI. The server owns the shells, so closing a frontend does not end the session.

gft new-session -s studio
gft attach-session -t studio

Connect coding agents

Set up the integration for your provider. In the workspace overview, drag between agent ports to create Read, Send, or Turn completed connections.

Agent setup and connection behavior →

Open a browser pane

Keep a page beside the terminal, or open an image, video, or PDF from the file tree. Chromium panes also expose automation controls for agents.

Browser API documentation →

Change the world around your work

Graffitty supports a flat workspace and pluggable 3D worlds. The world authoring guide describes how scenes are structured and what a world receives from the host.

World authoring guide →