Skip to content
Qwack

Quick Start

Install

Section titled “Install”
Terminal window
curl -fsSL https://qwack.ai/install | sh

Or download binaries directly from GitHub Releases.

This gives you the full qwack CLI — all OpenCode features plus native collaboration.

Authenticate

Section titled “Authenticate”
Terminal window
/qwack login

This opens your browser for GitHub OAuth. Once authenticated, your token is stored locally in ~/.config/qwack/config.json. No account is needed for solo use — login is only required for collaborative sessions.

Start a session

Section titled “Start a session”
Terminal window
/qwack start "my session"

This creates a new collaborative session. You automatically become the host — the person running the AI agent. A short join code is generated (e.g. GENTLE-WADDLE-26).

Invite collaborators

Section titled “Invite collaborators”
Terminal window
/qwack invite

This displays the short join code and a shareable link. Send either to your teammates.

Join a session

Section titled “Join a session”
Terminal window
/qwack join GENTLE-WADDLE-26

Collaborators join using the short code. They enter relay mode — their prompts route through the Qwack server to the host’s agent. Everyone shares one conversation context.

Collaborate

Section titled “Collaborate”

Once connected, everyone can:

  • Send prompts — type normally, prompts are relayed to the host’s agent
  • Send messages — /qwack msg hey, looking good! for side-channel chat (👤 prefix)
  • See everything — agent output, tool calls, file changes stream to all participants in real time

What’s next

Section titled “What’s next”
  • Commands — full reference for all /qwack slash commands
  • Architecture — how the host model works under the hood
  • Security — privacy guarantees, what the server sees