Quick Start

Get Stib up and running in under 5 minutes. This guide uses the simplest installation method — downloading the desktop app or pre-compiled binary.

Step 1: Download Stib

Download the latest release for your platform from the Download page.

TIP

For containerized deployment or building from source, see the Installation guide.

Step 2: Start the Server

Launch the Stib server:

macOS

# Open the downloaded .dmg, drag Stib to Applications, then launch it
open /Applications/Stib.app

Linux

# Make the binary executable and run it
chmod +x stib-server
./stib-server

Windows

# Run the installer, then launch Stib from the Start Menu
# Or execute the binary directly:
stib-server.exe

On first startup:

1. A data/ directory is created with stib.db (SQLite database) and logs/
2. A system tray icon appears (on desktop environments)
3. The web UI starts serving at http://localhost:30001

TIP

On headless Linux (no display server), Stib runs in headless mode — same functionality, no tray icon.

Step 3: Open the Web UI

Open your browser and navigate to:

http://localhost:30001

You'll see the Stib interface ready to go.

Step 4: Create Your First Project

1. Open Settings from the sidebar
2. Click New Project
3. Set a project name
4. Point it to a Git repository root on your machine (optional but recommended)
5. Click Create

A board is created with default columns: Backlog → Plan → Dev → Done.

Step 5: Create Your First Card

1. Click the + button on a column (e.g., Backlog)
2. Enter a title for the task
3. Write a prompt describing what the agent should do
4. Click Create
5. Drag the card to the Dev column — a Claude Code agent spawns and starts working

You can watch the agent execute in real-time by clicking on the card to open the overlay panel.

WARNING

Make sure Claude Code is authenticated before running agents. If you haven't configured it yet, run claude in your terminal and follow the setup prompts.

What's Next?

Now that Stib is running, explore more:

• Installation — Other installation methods (Docker, building from source)
• User Guide — Deep dive into all features
• Mobile App — Manage your agents from your phone

Need help? Open an issue on GitHub.