Usage

The Stib mobile app gives you full access to your boards, cards, and agents from your phone or tablet. This guide covers every feature available on mobile — from navigating the Kanban board to interacting with AI agents and managing projects.

TIP

Make sure your mobile app is connected to the server before proceeding. See the Connection guide for setup instructions.

Board Navigation

On mobile, the Kanban board uses a column filter bar at the top of the screen. Tap a column chip to display its cards — one column at a time. Each chip is color-coded by column type and shows a status dot summarizing card activity.

• Tap a column chip to select it and view its cards
• Tap the selected chip again to deselect it and return to the overview
• A search field in the app bar lets you filter cards across all columns by title

Board Selector

If your project has multiple boards, use the board selector icon in the app bar to switch between them. A bottom sheet lists all available boards for the current project.

Card Interactions

Cards behave differently depending on the column type:

Column Type	Tap Behavior
Active (Dev, Conversational, Skill)	Opens the full card detail screen
Passive (Backlog, Done) with editable cards	Opens an inline edit bottom sheet for quick title/description editing
Passive (Backlog, Done) without editable cards	Opens the full card detail screen

Floating Action Button

The FAB (floating action button) on the board screen provides a shortcut to open the AI Assistant chat — a free-form conversation not tied to any card.

Creating Cards

Tap the add card button in the app bar to open the card creation form.

Basic Fields

• Labels — select from label chips at the top of the form
• Title — card title (up to 80 characters)
• Prompt — multi-line description of the task for the agent
• Destination column — choose which column the card is created in

Prompt Toolbar

Below the prompt field, a toolbar offers two actions:

1. Attach — add images (from camera or gallery), commands, or skills to the prompt
2. Refine — open an AI pre-session to refine and improve the prompt before creating the card

Advanced Options

Expand the Advanced section to configure:

• Worktree — toggle Git worktree isolation and set a custom branch name
• Credential — select which Claude API credential to use
• Auto-mode — enable automatic pipeline progression
• Skip conversational — bypass conversational columns in the pipeline

Pipeline Configuration

Configure which columns the card will pass through in the pipeline. This mirrors the per-card pipeline override available on the web interface.

Image Attachments

Attach images to provide visual context to the agent:

• Camera — take a photo directly
• Gallery — pick an existing image from your device

Moving Cards

To move a card between columns:

1. Long-press on a card — you'll feel a haptic feedback confirming the gesture
2. A column picker bottom sheet appears with all available columns
3. Tap the target column to move the card

WARNING

If the card has a running agent, a confirmation dialog will appear asking you to force-stop the agent before moving. This prevents interrupting active work accidentally.

Card Details

Tap an active column card to open the card detail screen. The screen has two tabs:

Conversation Tab

• Live streaming of agent output with real-time updates
• Thinking indicators showing when the agent is reasoning
• Tool execution badges displaying which tools the agent is using
• Running summary showing a condensed view of the agent's progress
• Scroll-to-bottom button for quick navigation in long conversations
• Delta sync on WebSocket reconnect — when the app reconnects, only new messages are fetched to maintain data consistency

Diffs Tab

View the Git changes made by the agent for this card, including file-by-file diffs.

Header Actions

The card detail header provides quick actions:

• Move — relocate the card to another column
• Stop — halt the running agent
• Retry — restart the agent execution
• Edit — modify the card title and prompt
• Attachments badge — view attached files count

Bottom Interaction Banners

Contextual banners appear at the bottom of the screen:

• Plan approval — when a conversational agent requests approval to proceed, approve or reject the plan
• Relay pending — when the agent needs your input to continue, provide a response
• Input bar — type messages to interact with the agent during execution

Agent Interaction

When a card is in an active column, you can interact with the running agent directly from the card detail screen.

Live Streaming

Agent output streams in real time. Visual indicators help you follow the agent's work:

• Thinking blocks — collapsible sections showing the agent's reasoning process
• Tool execution badges — inline indicators of tool calls (file reads, writes, commands)
• Context usage percentage — shows how much of the agent's context window is consumed

Plan Approval Workflow

In conversational columns, the agent operates in plan mode. When it produces a plan:

1. A plan approval banner appears at the bottom
2. Review the agent's proposed approach
3. Approve to let the agent continue, or reject to ask for changes

Relay and Continue

When an agent reaches a point where it needs user input:

1. A relay pending banner appears
2. Type your response in the input bar
3. The agent continues with your guidance

Stop and Retry

• Stop — immediately halts the agent execution. Use this if the agent is going in the wrong direction.
• Retry — restarts the agent from the beginning with a fresh context.

AI Assistant

The AI Assistant is a free-form chat that is not tied to any card. Access it by tapping the FAB on the board screen.

• Message history — previous messages are preserved during your session
• Live streaming — responses stream in real time with thinking indicators
• Image attachments — attach images from camera or gallery (commands and skills are not available in assistant mode)
• Scroll-to-bottom button — quickly jump to the latest message
• Reset conversation — clear the chat history and start fresh from the app bar action

INFO

The AI Assistant uses the same Claude API credentials as your cards but operates independently — it does not have access to any card context or project files.

Project & Organization Management

Project List

The project list screen shows all projects accessible to you. If you belong to multiple organizations, an org selector dropdown appears in the title bar to filter projects by organization.

The user menu in the app bar provides access to:

• Settings — app preferences and credentials
• Organizations — manage your organizations
• Logout — sign out (in collaborative mode)

Creating a Project

1. Tap the create project button
2. A folder browser sheet appears (draggable from 50% to 95% screen height)
3. Browse to select the project folder — the project name auto-fills from the folder name
4. Configure optional settings:
   • Description — up to 200 characters
   • Color — choose from the color picker grid
5. Tap the floating submit button to create

WARNING

If the selected folder is not a Git repository, a warning will be displayed. Stib works best with Git-enabled projects for worktree isolation and diff tracking.

A success overlay confirms the project was created.

Project Settings

Access project settings to manage boards:

• Board list — view all boards with their type badge and default badge
• Create board — set a name, board type, and column template
• Rename board — change the board name
• Delete board — remove a board (the default board cannot be deleted)

Organization Management

• Create an organization with a name
• Rename or delete organizations via dialog actions
• Organization cards display the avatar, name, and member count
• Your personal organization is marked with a special indicator

Member Management

Within an organization:

• Add members by user ID with a role assignment
• Change roles via a radio dialog (Owner, Admin, Member)
• Remove members from the organization
• Role badges are color-coded: owner (accent), admin (active), member (gray)

Settings

Access settings from the user menu in the project list app bar.

Appearance

• Theme selector — choose between System, Dark, and Light themes using selector chips
• High contrast toggle — enable enhanced contrast for better readability

Claude Credentials

Manage your Claude API credentials:

• Each credential shows a color-coded usage dot indicating consumption level:

Color	Usage Level
Green	Below 71%
Amber	71% – 90%
Orange	91% – 94%
Red	95% and above

• Long-press a credential to view a usage details modal showing session and weekly consumption as percentage bars
• Tap a credential to set it as the default for new cards

Agent Display

• Reasoning toggle — show or hide the agent's thinking blocks in conversations
• Tool visibility — control which tool categories are visible in agent output:
  • Bulk show/hide — toggle all tools at once
  • Grouped categories — expand each category and toggle individual tools

Scripts

Run project scripts directly from the mobile app.

1. Tap the scripts button in the board app bar
2. An available scripts bottom sheet lists all configured scripts
3. Tap a script to launch it

Live Output

Script output streams in real time via WebSocket:

• Monospace display with colored output — stdout and stderr are visually distinguished
• Status bar at the bottom shows execution state:

Status	Display
Running	Spinner animation
Completed	Exit code (success)
Failed	Exit code (error)
Cancelled	Cancellation indicator

• Cancel a running script from the app bar action

Next Steps

TIP

• New to the mobile app? Start with the Connection guide to set up your server link.
• Explore the User Guide for detailed documentation on the web interface.