Documentation

Installation

SlayZone is a desktop app for macOS, Windows, and Linux. It is signed and notarized, so it installs just like any other app.

1. Download the installer for your OS from the homepage.
2. Run the installer and launch the app.
3. That's it. No cloud accounts required.

Creating Projects

SlayZone works with the folders already on your computer. You don't need to move or copy your code.

• Click the + button in the left sidebar.
• Pick any folder (usually the root of a Git repo).
• SlayZone will show your branches and files immediately.

The Kanban Board

The board helps you keep track of what you and your AI agents are doing. It's split into simple columns: Backlog, In Progress, Review, and Done.

• Tasks: Click + in a column to create a task.
• Opening Tasks: Click any card to open its workspace. Each task has its own terminals and browser.
• Auto-Status: SlayZone watches your terminal. When an agent starts working, the card on the board will visually update to show it's active.

Using Terminals

Every task card has its own terminals. These aren't just for AI—you can use them for anything.

• Persistence: If you close SlayZone, your terminals keep running. When you reopen the app, your history and logs are still there.
• Multiple Tabs: You can have one tab running a dev server (like npm run dev) and another for your AI agent.

Using the Browser

The embedded browser lets you see your app or read docs without leaving SlayZone.

• Live Preview: Set a URL in project settings to have it load automatically when you open a task.
• Mobile Testing: Use the device icons to see how your site looks on different screen sizes.
• AI Control: AI agents can "pilot" this browser—clicking buttons and taking screenshots to verify their work.

Working with Git

SlayZone helps you work on multiple things at once without making a mess of your repo.

• Worktrees: When you start a task, SlayZone can create a temporary "worktree." This lets you have different branches open in different tasks at the same time.
• Commit UI: Review your changes and commit them directly from the task sidebar.
• Conflicts: If a merge has conflicts, SlayZone provides a clear view to help you resolve them.

AI Modes & Keys

SlayZone supports any AI agent that runs in a terminal. To use them, make sure your API keys are set in your system shell (like in your .zshrc or .bashrc file).

Supported Modes:

• claude-code: Best for Anthropic's Claude. It tracks Thinking and Working states.
• gemini: For Google's Gemini. Includes real-time usage tracking.
• cursor-agent: Full support for the Cursor CLI.
• opencode: For running local models via Ollama.

`slay` CLI Reference

You can control SlayZone from your regular terminal using the slay command. (Install it via Settings → About).

# List your tasks
slay tasks list

# Create a new task
slay tasks create "Fix nav bug" --project "My App"

# Open a task in the desktop app
slay tasks open <id>

# See running background processes
slay processes list

Linear Sync

If you use Linear, you can connect it to SlayZone to keep your issues in sync.

• Import: Pull your assigned Linear issues onto your SlayZone board.
• Two-Way Sync: When you finish a task in SlayZone, it can automatically update the status in Linear for your team.

Privacy & Data

SlayZone is Local-First. This is important:

• Your code stays local: We never upload your source code to our servers.
• No accounts: You don't need to sign up or log in to use SlayZone.
• Your keys: We don't store your AI API keys. Your agents use the keys already on your machine.