BEAMMEUP OPERATIONS CONSOLE STARDATE 77415.2 SYSTEM OPERATIONAL

Gateway 01 · Shared Console

One window.
Two hands on the keyboard.

BeamMeUp opens a real terminal, on Windows as on Linux, where you and an AI agent type into the same session, live. What the agent does, you see. What you type, it sees. No hidden window, no ghost process.

02 · ALERT

An agent, no real terminal

Code agents run inside a sandboxed shell whose standard input is not a real terminal. The result: the slightest arrow-key menu, the slightest y/n confirmation, the slightest interactive wizard (eas credentials, npm init, an installer...) fails outright.

> npx eas credentials -p android

Input is required, but stdin is not readable.

PROCESS INTERRUPTED · NO INPUT POSSIBLE

03 · PROTOCOL

One command post, two operators

BeamMeUp is not a server you start ahead of time, nor an MCP extension to configure. The agent simply calls the program, the way it would call git or npm. If the console isn't lit up, it lights up, visible, right away.

HUMAN OPERATOR

Types on the keyboard, watches live, takes back control at any moment on the same session.

AI AGENT

Opens sessions, sends commands, reads results, never without the console being on screen.

DIRECTIVE 01 No stealth mode. No execution without a visible window. Ever.

04 · SYSTEMS

Onboard Systems

SYS.01

Shell Detection

On Windows: PowerShell 5.1 and 7, cmd.exe, Git Bash, every WSL distribution. On Linux: your login shell, then everything declared in /etc/shells. Nothing is assumed, everything is scanned on the real machine at every launch.

SYS.02

SSH & File Transfer

The system's real ssh/scp client is used as is: your known_hosts, your key agent, no homemade library to trust.

SYS.03

Session Labels

Name a session to find it again without memorizing a UUID, built for several agents running in parallel on the same machine.

SYS.04

Reusable Snippets

Save a frequent command, replay it with one keyword, without ever storing a secret in it.

SYS.05

Clean Read & Export

Grab a session's scrollback into a file, with or without ANSI codes, in full or just since the last command sent.

SYS.06

Real Vision

Remotely driven fullscreen, and a real screenshot of the console: the agent can literally look at what's on screen.

SYS.07

Command Completion Detection

The agent sends a command and waits for it to actually finish: output and return code sent back directly, no more guessing a delay then re-reading.

SYS.08

Remote Files Without a Session

List, read, write, rename, or delete a file on an SSH server without opening a tab: a minimal SFTP equivalent, via the same system client.

SYS.09

Multiple Workstations

Duplicate a session, reopen the last closed one, close everything without quitting the console, or bring a specific tab to the front among several running at once.

SYS.10

Always Standing By

Closing the window kills no session: a discreet icon stays in the notification area, with a menu to reopen the window, clear the tabs, or quit for good.

SYS.11

Optional Remote Access

Off by default. Opt in to view and control a session from your phone over the network (your Tailscale network, for instance): you choose the bind address and the authentication, nothing is forced on you.

05 · TRANSMISSIONS

Standard Command Sequence

Four transmissions are enough to open a session, work in it, then read back the result.

  1. COM‑1

    Survey the systems available on board

    beammeup shells
  2. COM‑2

    Open a named workstation (the identifier comes from the previous command: pwsh5 on Windows, bash on Linux)

    beammeup open --shell bash --label my-work
  3. COM‑3

    Send an instruction

    beammeup send my-work "npm run build" --enter
  4. COM‑4

    Read back the log, with no visual noise

    beammeup read my-work --plain --last
  5. COM‑5

    Or wait directly for the command to finish, with its result

    beammeup exec my-work "npm run build"

The full tutorial (every command, every case) lives in the repo README.

06 · SECURITY

Clearance & Safeguards

No Secret Stored

No password, no key, no token. Everything goes through your already configured system tools (SSH agent, known_hosts).

Elevation, By Design

The console runs as administrator so local sessions inherit its rights, without repeated prompts: a deliberate choice for a personal machine, not a shared server.

Local Channel Only

The control channel and the screenshot port only listen locally, restricted to the Windows account that launched the app.

Remote Access, Your Call

The one deliberate exception to local only, and it stays opt-in: you pick the bind address and the token, the console never decides for you.

07 · TRANSPORT

Ready to Come Aboard

Windows 10/11 and Linux. Installers built and signed on every release.

WINDOWS

MSI or NSIS installer, signed (Azure Trusted Signing).

winget install Breizhzion.BeamMeUp
LINUX

Debian package via the in-house repository, or a universal AppImage.

sudo apt install beammeup

Full instructions (apt repository key, AppImage, building from source) are in the repo README.