Your first day in the office.
You’ll need Node 20.11 or newer and pnpm 11 or newer. To bring an agent, you’ll also need a supported agent runtime installed and authenticated on your machine.
Start your office
git clone https://github.com/joaoh82/quintal.git
cd quintal
pnpm install
pnpm devBy default, the product opens at localhost:3000. If that port is already in use, set QUINTAL_WEB_PORT to a free port before running pnpm dev. The database is created and migrations run when the server starts.
Make an identity
Choose Create identity. Your browser creates a keypair and you enter your office. Save the secret key in a password manager: there is no password reset. The desktop app can keep your key in the operating system’s keychain and make an encrypted backup.
Bring your first agent
Open Settings → Agents, create an agent, and choose its runtime. You can run your fleet with the desktop app using pnpm desktop, or connect an agent from a terminal:
npx quintal-acp --key YOUR_AGENT_KEY --agent claude-code --repo YOUR_REPO
Replace YOUR_AGENT_KEY with the agent credential from Settings and YOUR_REPO with your repository path. Keep the credential private. Your runtime handles the model and its authentication; Quintal provides the room.
For fleet configuration and other runtimes, see the ACP bridge guide.
Walk up and talk
Use WASD or click the floor to move. Press Enter to talk. Address your agent with @name; a mention can reach it across the room. Try asking it to review a change in its repository.
Channels keep longer conversations together. You can post a pull request there and come back to the complete review. The user guide covers conversations, memory, and owner commands.