BossConsole AGENTS.md

AGENTS.md

This file provides guidance to coding agents working with this repository.

Project Overview

BOSS (Business Operating System Service) is a desktop application built with Kotlin Multiplatform and Compose Multiplatform. It features WebAuthn/passkey authentication, integrated browser (JxBrowser), terminal integration (BossTerm), customizable keyboard shortcuts, and role-based access control.

Target Platforms: Desktop only (macOS, Windows, Linux).

Essential Commands

./gradlew run                    # Run desktop application
./gradlew showVersion           # Display current version
./gradlew test                  # Run tests
./gradlew build                 # Build application
./gradlew packageDmg            # Build macOS DMG
./gradlew packageMsi            # Build Windows MSI
./gradlew packageDistributionForCurrentOS  # Linux packages
./gradlew incrementVersion      # Increment patch version

Workflow Rules

IMPORTANT: Do NOT run ./gradlew run in a blocking/foreground way just to test - the user runs and tests the app themselves. Exception: launching the app in a dedicated bottom split pane is allowed (backgrounded so it doesn't wedge the pane).

Running commands in a visible terminal pane

When a terminal MCP server is available, prefer it over the plain Bash tool for commands worth showing - it runs in a visible BossTerm pane and still returns stdout/stderr/exit code. Two servers may be present depending on which app hosts the session; use whichever the session's SessionStart hook designates:

• mcp__boss__* - exposed by the terminal-tab plugin inside BossConsole (e.g. mcp__boss__run_command, run_in_sidebar).
• mcp__bossterm__* - exposed by the standalone BossTerm app.

For a bottom split use panel: horizontal_split. Reuse a pane across calls by passing back its pane_id. Keep plain Bash for trivial read-only commands where opening a visible pane is churn. (Do not mix the two servers in one session - they target different app instances.)