gitwtfhub

wtf is bossconsole?

risa-labs-inc/bossconsole — explained in plain English

Analysis updated 2026-05-18

146KotlinAudience · developerComplexity · 4/5LicenseSetup · easy

TL;DR

A native desktop console that gives AI coding agents a real browser, terminal, and editor, while exposing over 100 of its own tools back to the agent.

Mindmap

mindmap
  root((BossConsole))
    What it does
      Real browser and terminal
      Secret manager
      Agent controlled tools
    Bring your own agent
      Claude Code
      Codex
      Gemini
      OpenCode
    Tech stack
      Kotlin
      JVM
      Compose Multiplatform
    Features
      Toolbox plugin store
      Shareable terminal
      Live hot reload

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Give an AI coding agent a real browser, terminal, and editor with control over what it can touch.

REASON 2

Let an agent inspect and operate the BOSS app itself through its own built-in tools.

REASON 3

Share a live terminal session to a phone with a QR code to check on a running agent.

REASON 4

Automate browser tasks with an agent-driven browser that pulls saved logins from a secret manager.

What's in the stack?

KotlinJVMCompose MultiplatformMCP

How it stacks up

risa-labs-inc/bossconsolemarshallbear1/react-native-system-thumbnailsv-modal/vmodal_sdk_android
Stars146145152
LanguageKotlinKotlinKotlin
Setup difficultyeasymoderatemoderate
Complexity4/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Pre-built installers exist for macOS, Windows, and Linux on Intel and ARM, requires bringing your own agent CLI such as Claude Code or Codex.

Open source under the Apache 2.0 license, which allows free use, modification, and commercial redistribution.

Wtf does this do

BossConsole, called BOSS, is a desktop application that gives an AI coding agent a real workspace to operate in, including a browser, a terminal, a code editor, and a place to store passwords and other secrets safely. Instead of being tied to one AI provider, the app is designed to work with several different agents, such as Claude Code, Codex, Gemini, or OpenCode, and the person running it chooses exactly what each agent is allowed to touch. Unlike many similar tools that are built on Electron, a common web based framework for desktop apps, BOSS is built natively on the Java virtual machine using Kotlin, which the README says gives it real multi threading and the ability to reload plugins live while the app keeps running, without needing to restart. A central idea in the README is that BOSS is not just somewhere an agent works, it is also something the agent can inspect and operate. The app exposes over one hundred of its own internal functions, such as listing open tabs, reading terminal output, or checking git status, as tools an agent can call through a system called MCP. This means an agent does not only talk about code, it can observe what BOSS itself is currently doing and act on that information directly. BOSS also includes its own embedded, scriptable web browser that an agent can navigate and automate, with saved logins pulled from a built in secret manager so the AI model itself never sees the raw passwords. A built in terminal can be shared to another device, including a phone, using a QR code, so a person can check on or interact with a running session remotely. The app also ships with an extensible collection of plugins the README calls a Toolbox, similar to an app store built into the program itself. The project targets enterprises, scientific teams, and researchers, and it is open source under the Apache 2.0 license, with pre built installers available for macOS, Windows, and Linux on both Intel and ARM hardware.

Yoink these prompts

Prompt 1
Explain how BossConsole's mcp__boss__* tools let an agent observe and control the app itself.
Prompt 2
Show me how to set up which files and tools an agent is allowed to touch in BossConsole.
Prompt 3
Walk me through sharing a BossConsole terminal session to my phone with a QR code.
Prompt 4
Help me compare running Claude Code inside BossConsole versus running it in a plain terminal.

Frequently asked questions

wtf is bossconsole?

A native desktop console that gives AI coding agents a real browser, terminal, and editor, while exposing over 100 of its own tools back to the agent.

What language is bossconsole written in?

Mainly Kotlin. The stack also includes Kotlin, JVM, Compose Multiplatform.

What license does bossconsole use?

Open source under the Apache 2.0 license, which allows free use, modification, and commercial redistribution.

How hard is bossconsole to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is bossconsole for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.