Zozo Docs

Quickstart ​

Setup takes a newly invited hosted tenant from sign-in to a Stack that can Dispatch GitHub Issues. Before you begin, have a GitHub account, a Claude or Codex Credential, and a GitHub personal access token ready.

During account signup, choose the EU Home Region. Stacks are hosted in the EU (Germany or Finland) for now.

Zozo provides Node.js 22 and Python 3 by default, and it can provision repository-declared versions or other mise-supported Toolchains before a Run starts. See Declare a Toolchain when your repository pins a version or uses another language ecosystem.

Sign In ​

Open app.zozohq.com, enter the invite code from whoever administers your Zozo deployment, and select Continue with GitHub. After you approve the GitHub sign-in and finish the account steps, the app provisions your Stack. When it shows Your Dashboard is ready, select Open your Dashboard to enter the Stack's own Dashboard.

The provisioning page checks your Stack automatically while you wait. The control-plane sign-in and your Stack's own session are separate, so Open your Dashboard completes a secure handoff and signs you in to the Dashboard. See Auth & Consent for why.

Complete the Three Steps ​

The three Setup steps appear when you enter an incomplete Stack for the first time. From app.zozohq.com, sign in and select Open your Dashboard. The Dashboard opens Setup automatically. Together, its three steps provide everything Zozo needs to watch a Project and Dispatch its Issues:

  1. Credential: Connect a Runtime. Name a Credential, choose Claude or Codex, choose its kind, and provide the value. A Solo tenant running Zozo against their own repositories and spending their own money will usually use a personal subscription Credential. A Billed tenant running work for a client they invoice will usually use that client's vendor API key. A subscription Credential also asks you to record consent. See Connect a Personal Subscription Credential for the vendor-specific preparation.
  2. Dispatcher: Connect GitHub. Provide the GitHub personal access token the Dispatcher will use to read Issues and repositories and to write branches and Pull Requests. Setup lists the required permissions. A fine-grained token is suitable for repositories you own. Use a classic token when Zozo must see collaborator repositories owned by someone else.
  3. Project: Watch a Project, and set its pace. Pick a repository, its priority, and whether it's active, then choose one Pace preset: review-paced waits for you to clear the previous Pull Request; full-speed keeps selecting Issues without that wait; and autonomous also merges ready changes. These are presets for the underlying settings, which remain editable on Projects.

Setup derives completion from the same Credentials, GitHub, and Projects state used everywhere else. You can skip it and configure the same state on Credentials and Projects. If the Stack is still incomplete, Resume Setup on the Dashboard brings you back.

Start Work ​

The Frontier contains open Issues carrying the ready-for-agent label that are safe for the Dispatcher to pick up. Add that label to an Issue in the Project you just watched, then return to Setup's Stack ready screen and select ▶ Start Dispatching. This enables Auto-dispatch, which keeps selecting eligible Issues until you select Suspend on the Dashboard.

The Dashboard shows the resulting Thread and its Runs live. A Run's status moves from queued to running, then to completed, failed, or Interrupted. The Messages, Tools, and System filters separate the Events in its timeline.

Use the Regular Pages ​

If you skipped Setup or are reconfiguring an existing Stack, follow the same path through the regular Dashboard pages:

  1. Open Credentials (#/auth). Under Add a Credential, choose its name, Provider, and kind. Supply the token, key, or auth file, and record consent when the subscription kind requires it. Wait for the Credential to show authenticated.
  2. On the same page, connect the Dispatcher's GitHub credential. Choose a fine-grained or classic token, follow the displayed permission guidance, and save it after Zozo verifies it.
  3. Open Projects (#/projects) and add a repository. Choose review-paced, full-speed, or autonomous, along with its priority and active state.
  4. Label an open GitHub Issue ready-for-agent, then enable Auto-dispatch on the Dashboard. The Dispatcher will claim the eligible Issue during a Selection Pass and stream its Runs into the Dashboard.

The control plane starts a short-lived, single-use handoff to your Stack, which redeems it and creates its own local session. The invite and browser redirects handle this flow, so you don't need to copy session tokens or call handoff routes yourself.

What's Next ​

Docs for Zozo: a coding-agent harness.

Copyright © Zozo