Skip to content
zidane
Desktop

All your sessions in one window.

zidane-gui runs the same engine as the terminal app and opens the same sessions. With the daemon on, a run keeps going after you close the window.

How to installDesktop docs
npm install -g zidane-gui
apiRate limit the chat endpoint
Rate limit the chat endpoint: 20 requests a minute per IP, and tell clients how long to wait when it trips. The chart shows who hit it last night.

    • The chat route now takes a token from a per-IP bucket: 20 a minute, with bursts of 5. Over the limit it answers 429 with a Retry-After header, so clients know how long to wait.

      All 44 server tests pass.

      Opus 5.538s4$0.0717k1.1k
    Document it in docs/server.mdx, then commit.

      • Documented under Limits in docs/server.mdx and committed as 83dfea7.

        Opus 5.552s3$0.0912k980

      Built from the app's components, playing a scripted agent.

      Sessions

      Find any session.

      The sidebar groups sessions by project, date or state, with a saved filter per space. Search covers titles and every conversation's text.

      Sessions
      Transcript

      Full or compact transcript.

      Full shows each tool call with its output. Compact folds each exchange to one row.

      Transcript
      Rate limit the chat endpoint: 20 requests a minute per IP, and tell clients how long to wait when it trips. The chart shows who hit it last night.

        • The chat route now takes a token from a per-IP bucket: 20 a minute, with bursts of 5. Over the limit it answers 429 with a Retry-After header, so clients know how long to wait.

          All 44 server tests pass.

          Opus 5.538s4$0.0717k1.1k
        Document it in docs/server.mdx, then commit.

          • Documented under Limits in docs/server.mdx and committed as 83dfea7.

            Opus 5.552s3$0.0912k980
          Composer

          Pick the profile, model and effort.

          The composer holds the agent profile, model chain and reasoning effort. If a model fails before streaming, the next in the chain takes over.

          Interactions

          Plans and questions wait for you.

          present_plan and ask_user pause the run on a card. Answer in the chat, or later from the Inbox tab.

          PlanPublish the v8 notes

          Link docs/releases/v8.md from the changelog, tag v8.0.0 and open a pull request.

          1. 1.
            Link the notes from CHANGELOG.md
          2. 2.
            Tag v8.0.0
          3. 3.
            Open a pull request
          Command palette

          Every action from the keyboard.

          ⌘K opens the palette. Each action shows its shortcut, and settings toggle in place.

          Context

          See what fills the context window.

          The composer's orb fills as the session uses its window. Open it for a breakdown by category and the cost so far.

          61.0k / 1.00M (6%)
          System prompt3.24k<1%
          Rules (AGENTS.md)~1.87k<1%
          Skills~1.12k<1%
          Conversation~40.2k4%
          Deferred
          System tools (deferred)~4.38k<1%
          Autocompact buffer200.0k20%
          Free space939.0k94%
          Active skills
          release-notes
          Last turn
          Cached (read)56.8k
          Cache write1.89k
          Fresh input2.31k
          Output1.24k
          ~ Estimated. This provider does not report exact counts.
          Side panel

          Files, diffs and a browser next to the chat.

          Tabs hold the session's artifacts, diffs, files, inbox and todos, plus a dev browser for your app. The Terminal tab runs in the daemon.

          server/src/routes/chat.ts
          + +const limiter = bucket({ perMinute: 20, burst: 5 });
          export const chat = route('/chat', async (req) => {
          + + const verdict = limiter.take(req.ip); if (!verdict.ok) return tooMany(verdict.retryAfterMs);
          return stream(await agent.run(req.body)); });
          Remote hosts

          Run sessions on another machine.

          Turn on the experimental Remote hosts setting and add a zidane-server by URL and token. The sidebar then groups sessions by host.

          Sessions2 running
          New chat

          Install the desktop app.

          It ships on npm for macOS and Linux, and a global install adds a launcher to Spotlight or your applications menu.

          How to installDesktop docs
          npm install -g zidane-gui
          Other surfaces

          Other ways to use Zidane.