risa-labs-inc/BossConsole

Open-source, multi-platform harness for AI agents - a native, multi-threaded operator's console (JVM, not Electron) to run Claude Code, Codex, Gemini or OpenCode with a real browser, terminal, editor, secrets & 100+ MCP tools. Built for enterprises, science & research.

Kotlin

809

1,188 commits

updated Oct 6, 2026

See the code

See what people are saying

SourceMessageScoreDate

I started BossConsole as a side project in February 2025. Today I’m sharing the launch. (r/SideProject)

I’m Shivang, co-founder and CTO of Risa Labs. We work on applying AI to critical problems in oncology workflows. BossConsole started as my side project in February 2025, from a frustration I kept coming back to. I loved IntelliJ. Still do. But I wanted it to evolve faster towards how I was…

1

Oct 7, 2026

README

Watch the BOSS Console launch film

BOSS Console

Bring your agent. Choose its tools.

A desktop workspace where you and your AI agents work with a real browser, terminal, editor, and an extensible toolbox.

▶ Watch the 64-second film · Download BOSS · Explore the wiki · Open live sessions

BOSS release Platforms License

Product website · Visual walkthrough · Contribute


One workspace for the whole task

Keep the page you are researching beside the agent working on it. Run commands, inspect files, review changes, and arrange everything into split panes and saved Spaces.

BOSS runs on the JVM with Kotlin and Compose Multiplatform. Its browser, terminal, editor, and other tools come from dynamic plugins, so the workspace can grow with the work.

BOSS on macOS with an Arcade pane beside Fluck Agent

A real macOS workspace: a 2048 board beside Fluck Agent looking up tools. This capture shows work in progress.

BrowseBuildOrganize
Fluck Browser brings real webpages into the workspace, with agent tools for navigation and page interaction.BossTerm + BossEditor put commands and code beside the task. Add Git, run configurations, and logs from Toolbox.Spaces + split panes keep projects and activities together. Save layouts and move between tasks.

Explore Spaces and everyday use →

Run any AI coding agent

Claude Code · Codex · Gemini CLI · OpenCode

Bring the CLI you already use. Open a BOSS terminal, connect it through Toolbox → MCP or the BossTerm AI menu, and choose which BOSS tools it can call. The local boss MCP server discovers tools from active plugins, including browser, terminal, editor, Git, and automation tools.

An agent can inspect the running workspace and act in it: read a terminal's output, open a file, navigate a browser tab, or run a command. The available tools depend on your installed plugins and access settings.

From page context to visible results

A webpage attached as context in Fluck Agent beside the browser

1. Give the agent context. In this Fluck Agent example, the current BOSS webpage is attached to the conversation while staying visible in the neighboring pane.

Fluck Agent asks for approval to open example.com

2. Review the requested action.
Fluck Agent asks before opening the destination. This is that agent's approval UI; other agents and tool policies can behave differently.

example.com opened in a real browser tab beside the source page

3. Inspect the result.
The destination opens as a real browser tab. You can see and interact with the same workspace the agent is using.

These three product captures show BOSS 9.5.19 on Linux. The current release may look different.

Connect your agent → · See the complete walkthrough →

Build your own toolbox

Install the tools you need from the built-in Toolbox. Browse plugins, manage updates, enable or disable tools, and customize the workspace around your project.

Toolbox setup with browser, terminal, editor, and agent plugins selected

Development setup in BOSS 9.5.32 on Linux: review the selected tools before installing them.

Start with a browser, terminal, and editor. Add Docker or Kubernetes for infrastructure, notebooks for research, automation for repeatable browser work, or your own plugin.

Tool Creator scaffolds a plugin project. Tool Evolver helps inspect and improve an existing tool. Many plugins hot-reload while the host stays open; infrastructure updates can require a restart.

Discover and manage plugins → · Build a plugin → · Browse the ecosystem →

Your workspace, on another device

Open cli.risaboss.com →

Sign in with the same BOSS account to find your shared sessions. The portal separates terminals from application windows, so you can open the kind of session you need.

BossTerm live sessionsBossConsole live sessions
Open shared terminals from standalone BossTerm or BossConsole. View output or control the terminal according to the share's access settings.View and control a shared BOSS window from a browser or another BossConsole. One controller holds the input lease at a time.
BossTerm also offers View and Control links with QR codes for sharing to a phone or another device.Full-window hosting is currently a macOS 14+ preview and needs Screen Recording permission. Desktop BOSS itself also supports Windows and Linux.

Full-window sharing publishes one encrypted video stream per window through Cloudflare Realtime SFU for multiple viewers, with encrypted remote-control messages. Same-account access and automatic control are enabled by default for fresh preferences; saved opt-outs are preserved. The account backend remains trusted for admission and key delivery.

Sharing setup, access settings, and protocol diagram →

You decide what your agents can touch

Choose the tool access that fits the task through Toolbox → MCP.

  • Per-tool switches remove disabled tools from the agent's available BOSS toolset and block calls to them.
  • Roles and permissions govern tools that declare permission requirements. Admin users bypass role checks, but still obey the per-tool switches.
  • Secret Manager supports credential references and browser autofill so supported calls can use a credential without placing its value in the agent transcript. Explicit secret-read tools have different behavior.
  • Signed store plugins bind the plugin identity, version, and JAR content. A valid signature establishes provenance, not that a plugin is safe.

These controls apply to calls through BOSS. They do not sandbox an external agent, and plugins run in the host process. Disabling a tool does not cancel work already authorized. An authorized page or tool receiving a secret can still expose it.

Security and privacy → · Secret-reference guarantees → · Infrastructure plugin audit →


Downloads

Install BOSS, sign in, then use Toolbox to choose your initial tools.

PlatformArchitectureInstaller
macOSApple Silicon + IntelHomebrew · DMG
Windowsx64MSI
WindowsARM64MSI
LinuxAMD64DEB · RPM · JAR
LinuxARM64DEB · RPM · JAR

On macOS:

brew install --cask boss

For installation scripts, platform notes, and your first workspace, follow the Getting started guide. Download links resolve to the latest stable release; use all releases to choose a specific version.

Documentation

The BossConsole wiki is the product guide. Start with a workflow, then follow its links into the technical references.

What you want to doRead
Install BOSS and set up your first toolsGetting started
See the app in actionProduct walkthrough
Arrange tabs, splits, and projectsSpaces and everyday use
Connect an agent and manage toolsAgents and MCP
Install or build a pluginPlugins
Open your terminal or window remotelyLive sessions and window sharing
Use BOSS from a shell or scriptCLI guide
Understand access and credentialsSecurity and privacy
Diagnose a problemTroubleshooting
Contribute to the host or plugin platformDevelopment and contributing
Technical references, architecture, and benchmarks

Development

Use JDK 17 and the included Gradle wrapper. Begin with CONTRIBUTING.md for setup, validation, and the contribution workflow. Pull requests target dev.

git clone https://github.com/risa-labs-inc/BossConsole.git
cd BossConsole
git switch dev
./gradlew showVersion

Browser and backend features need local configuration. Follow the development guide for local.properties, build commands, and isolated testing. Repository-specific instructions live in AGENTS.md.

Install the BOSS CLI through Toolbox → Tools → Install BOSS CLI to inspect and operate the running workspace:

boss status --json
boss doctor
boss mcp list --filter browser
boss file README.md

Complete CLI reference → · Plugin authoring and MCP →

Open source & ecosystem

BOSS is licensed under Apache-2.0. The host and tools live in separate repositories; plugins release independently.

ProjectRole
BossConsoleDesktop host, workspace UI, authentication, and sharing
boss-pluginsPlugin catalog and submodule workspace
boss-plugin-apiPlugin contracts provided by the host
BossTermTerminal library, bundled by the terminal plugin
BossEditorEditor library, bundled by the editor plugin
boss-microkernel-runtimeOut-of-process plugin runtime
BossConsole-ReleasesInstallers and release history

Core plugins: Fluck Browser · Terminal · Editor

Support

Report an issue · Troubleshoot · Enterprise inquiries


Your agent. Real tools. You in control.

Download BOSS · Watch the film · Read the wiki · Open your sessions

bossconsole.ai · risaboss.com · Risa Labs

Video from bossconsole.ai. Original product captures from risaboss.com, preserved in the wiki with source attribution. Licensed under Apache-2.0.

agent-harness
ai-agents
browser
claude-code
codex
compose-multiplatform
desktop-app
gemini
hot-reload
jvm
kotlin-multiplatform
llm
mcp
model-context-protocol
multithreading
opencode
open-source
rbac
terminal

risa-labs-inc/BossConsole

Open-source, multi-platform harness for AI agents - a native, multi-threaded operator's console (JVM, not Electron) to run Claude Code, Codex, Gemini or OpenCode with a real browser, terminal, editor, secrets & 100+ MCP tools. Built for enterprises, science & research.

Kotlin

809

1,188 commits

updated Oct 6, 2026

See the code

See what people are saying

SourceMessageScoreDate

I started BossConsole as a side project in February 2025. Today I’m sharing the launch. (r/SideProject)

I’m Shivang, co-founder and CTO of Risa Labs. We work on applying AI to critical problems in oncology workflows. BossConsole started as my side project in February 2025, from a frustration I kept coming back to. I loved IntelliJ. Still do. But I wanted it to evolve faster towards how I was…

1

Oct 7, 2026

README

Watch the BOSS Console launch film

BOSS Console

Bring your agent. Choose its tools.

A desktop workspace where you and your AI agents work with a real browser, terminal, editor, and an extensible toolbox.

▶ Watch the 64-second film · Download BOSS · Explore the wiki · Open live sessions

BOSS release Platforms License

Product website · Visual walkthrough · Contribute


One workspace for the whole task

Keep the page you are researching beside the agent working on it. Run commands, inspect files, review changes, and arrange everything into split panes and saved Spaces.

BOSS runs on the JVM with Kotlin and Compose Multiplatform. Its browser, terminal, editor, and other tools come from dynamic plugins, so the workspace can grow with the work.

BOSS on macOS with an Arcade pane beside Fluck Agent

A real macOS workspace: a 2048 board beside Fluck Agent looking up tools. This capture shows work in progress.

BrowseBuildOrganize
Fluck Browser brings real webpages into the workspace, with agent tools for navigation and page interaction.BossTerm + BossEditor put commands and code beside the task. Add Git, run configurations, and logs from Toolbox.Spaces + split panes keep projects and activities together. Save layouts and move between tasks.

Explore Spaces and everyday use →

Run any AI coding agent

Claude Code · Codex · Gemini CLI · OpenCode

Bring the CLI you already use. Open a BOSS terminal, connect it through Toolbox → MCP or the BossTerm AI menu, and choose which BOSS tools it can call. The local boss MCP server discovers tools from active plugins, including browser, terminal, editor, Git, and automation tools.

An agent can inspect the running workspace and act in it: read a terminal's output, open a file, navigate a browser tab, or run a command. The available tools depend on your installed plugins and access settings.

From page context to visible results

A webpage attached as context in Fluck Agent beside the browser

1. Give the agent context. In this Fluck Agent example, the current BOSS webpage is attached to the conversation while staying visible in the neighboring pane.

Fluck Agent asks for approval to open example.com

2. Review the requested action.
Fluck Agent asks before opening the destination. This is that agent's approval UI; other agents and tool policies can behave differently.

example.com opened in a real browser tab beside the source page

3. Inspect the result.
The destination opens as a real browser tab. You can see and interact with the same workspace the agent is using.

These three product captures show BOSS 9.5.19 on Linux. The current release may look different.

Connect your agent → · See the complete walkthrough →

Build your own toolbox

Install the tools you need from the built-in Toolbox. Browse plugins, manage updates, enable or disable tools, and customize the workspace around your project.

Toolbox setup with browser, terminal, editor, and agent plugins selected

Development setup in BOSS 9.5.32 on Linux: review the selected tools before installing them.

Start with a browser, terminal, and editor. Add Docker or Kubernetes for infrastructure, notebooks for research, automation for repeatable browser work, or your own plugin.

Tool Creator scaffolds a plugin project. Tool Evolver helps inspect and improve an existing tool. Many plugins hot-reload while the host stays open; infrastructure updates can require a restart.

Discover and manage plugins → · Build a plugin → · Browse the ecosystem →

Your workspace, on another device

Open cli.risaboss.com →

Sign in with the same BOSS account to find your shared sessions. The portal separates terminals from application windows, so you can open the kind of session you need.

BossTerm live sessionsBossConsole live sessions
Open shared terminals from standalone BossTerm or BossConsole. View output or control the terminal according to the share's access settings.View and control a shared BOSS window from a browser or another BossConsole. One controller holds the input lease at a time.
BossTerm also offers View and Control links with QR codes for sharing to a phone or another device.Full-window hosting is currently a macOS 14+ preview and needs Screen Recording permission. Desktop BOSS itself also supports Windows and Linux.

Full-window sharing publishes one encrypted video stream per window through Cloudflare Realtime SFU for multiple viewers, with encrypted remote-control messages. Same-account access and automatic control are enabled by default for fresh preferences; saved opt-outs are preserved. The account backend remains trusted for admission and key delivery.

Sharing setup, access settings, and protocol diagram →

You decide what your agents can touch

Choose the tool access that fits the task through Toolbox → MCP.

  • Per-tool switches remove disabled tools from the agent's available BOSS toolset and block calls to them.
  • Roles and permissions govern tools that declare permission requirements. Admin users bypass role checks, but still obey the per-tool switches.
  • Secret Manager supports credential references and browser autofill so supported calls can use a credential without placing its value in the agent transcript. Explicit secret-read tools have different behavior.
  • Signed store plugins bind the plugin identity, version, and JAR content. A valid signature establishes provenance, not that a plugin is safe.

These controls apply to calls through BOSS. They do not sandbox an external agent, and plugins run in the host process. Disabling a tool does not cancel work already authorized. An authorized page or tool receiving a secret can still expose it.

Security and privacy → · Secret-reference guarantees → · Infrastructure plugin audit →


Downloads

Install BOSS, sign in, then use Toolbox to choose your initial tools.

PlatformArchitectureInstaller
macOSApple Silicon + IntelHomebrew · DMG
Windowsx64MSI
WindowsARM64MSI
LinuxAMD64DEB · RPM · JAR
LinuxARM64DEB · RPM · JAR

On macOS:

brew install --cask boss

For installation scripts, platform notes, and your first workspace, follow the Getting started guide. Download links resolve to the latest stable release; use all releases to choose a specific version.

Documentation

The BossConsole wiki is the product guide. Start with a workflow, then follow its links into the technical references.

What you want to doRead
Install BOSS and set up your first toolsGetting started
See the app in actionProduct walkthrough
Arrange tabs, splits, and projectsSpaces and everyday use
Connect an agent and manage toolsAgents and MCP
Install or build a pluginPlugins
Open your terminal or window remotelyLive sessions and window sharing
Use BOSS from a shell or scriptCLI guide
Understand access and credentialsSecurity and privacy
Diagnose a problemTroubleshooting
Contribute to the host or plugin platformDevelopment and contributing
Technical references, architecture, and benchmarks

Development

Use JDK 17 and the included Gradle wrapper. Begin with CONTRIBUTING.md for setup, validation, and the contribution workflow. Pull requests target dev.

git clone https://github.com/risa-labs-inc/BossConsole.git
cd BossConsole
git switch dev
./gradlew showVersion

Browser and backend features need local configuration. Follow the development guide for local.properties, build commands, and isolated testing. Repository-specific instructions live in AGENTS.md.

Install the BOSS CLI through Toolbox → Tools → Install BOSS CLI to inspect and operate the running workspace:

boss status --json
boss doctor
boss mcp list --filter browser
boss file README.md

Complete CLI reference → · Plugin authoring and MCP →

Open source & ecosystem

BOSS is licensed under Apache-2.0. The host and tools live in separate repositories; plugins release independently.

ProjectRole
BossConsoleDesktop host, workspace UI, authentication, and sharing
boss-pluginsPlugin catalog and submodule workspace
boss-plugin-apiPlugin contracts provided by the host
BossTermTerminal library, bundled by the terminal plugin
BossEditorEditor library, bundled by the editor plugin
boss-microkernel-runtimeOut-of-process plugin runtime
BossConsole-ReleasesInstallers and release history

Core plugins: Fluck Browser · Terminal · Editor

Support

Report an issue · Troubleshoot · Enterprise inquiries


Your agent. Real tools. You in control.

Download BOSS · Watch the film · Read the wiki · Open your sessions

bossconsole.ai · risaboss.com · Risa Labs

Video from bossconsole.ai. Original product captures from risaboss.com, preserved in the wiki with source attribution. Licensed under Apache-2.0.

agent-harness
ai-agents
browser
claude-code
codex
compose-multiplatform
desktop-app
gemini
hot-reload
jvm
kotlin-multiplatform
llm
mcp
model-context-protocol
multithreading
opencode
open-source
rbac
terminal