GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - ReagentX/fleetcom: A fleet-view supervisor for concurrent shell commands

BranchesTags
Open more actions menu

Latest commit

 

History

576 Commits
576 Commits

Folders and files

NameName
Last commit message
Last commit date
.github/workflows
.github/workflows
 
 
docs
docs
 
 
src
src
 
 
tests
tests
 
 
.gitattributes
.gitattributes
 
 
.gitignore
.gitignore
 
 
Cargo.lock
Cargo.lock
 
 
Cargo.toml
Cargo.toml
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 

Repository files navigation

fleetcom

Use fleetcom to supervise your local development fleet: multiplexers, application servers, REPLs, builds, tests, and AI agent sessions.

Key Features

Fleet view

Monitor every task's state and live output from one dashboard: test results, dev servers, and which agent is waiting on you.

fleetcom fleet view

Quick peek

Press Space for a quick peek at a task’s live screen without attaching to it.

fleetcom quick peek

Attach and interact

Press Enter to take control of a task, then Ctrl-\ to return to the dashboard without interrupting it.

fleetcom attach

Custom groups

Organize related tasks into named groups across working directories.

fleetcom custom-group view

Resume agent sessions

Launch claude, codex, grok, or omp from the Agent page (n, then Tab). Rerun the task or reload a saved session to resume the conversation.

fleetcom Agent page

Operational model

Managing several long-lived commands across terminal panes is pesky, especially when you need to reconnect later. With fleetcom:

  • Run each command in its own PTY and group tasks by state, working directory, or named group.
  • Keep tasks running under a daemon across client disconnects.
  • Save and reload task recipes: directories, commands, group assignments, display names, tags, the flagship, and which tasks had finished.
  • Rerun a completed task in place, keeping its identity, group, and name.
  • Launch claude, codex, grok, and omp as managed agents and resume their conversations on rerun and reload.
  • Recover the current task set from automatic snapshots.

Documentation

See docs/ for configuration, on-disk state, session files, resuming supported agent sessions, commands, and a complete first run.

Installation

Unix only: PTYs and process-group signals (killpg) are required.

Cargo (recommended)

For normal use, install the published crate from crates.io:

cargo install fleetcom

See Source installation to build from a repository clone.

Usage

Connect to the daemon, autostarting it when necessary, and open the dashboard by invoking:

fleetcom

See the invocation reference for sessions, foreground mode, scrollback, and daemon shutdown.

Key Commands

Dashboard

Use the two dashboard hints for common actions; press ? for the expanded key reference:

  ❯ n run · @ dir · / find · s sort
  ↑↓ select · enter attach · space peek · ? controls

Attached

  • Press Ctrl-\ to background the task and return to the dashboard.
  • Press ] on the dashboard to mark a flagship task. Press Ctrl-] to attach to it, and again to return.
  • Other supported input is forwarded to the task's PTY.

See docs/commands.md for every key and launch flag, including the routing mechanics.

How it works

fleetcom runs each task in a separate pseudo-terminal, emulated with alacritty_terminal. The dashboard preview, peek overlay, and attached view all read the same emulated screen grid. This preserves terminal state as you move between views, including for full-screen programs such as vim and htop. See docs/how-it-works.md for terminal emulation, input routing, and activity grouping.

Scope and tradeoffs

Use fleetcom for concurrent build, test, watch, server, and interactive-agent processes. Each task is one command rather than a persistent shell session.

When to use fleetcom

  • You need one place to observe, tag, and attach to several long-lived commands.
  • You need to reattach to jobs after closing a terminal.
  • The same command set is launched often enough to justify a saved session.
  • Captured agent conversations (claude, codex, grok, omp) should resume on rerun.

When to avoid fleetcom

  • You primarily need persistent interactive shell workspaces; use tmux or zellij directly. You can supervise a multiplexer with fleetcom, but cannot use it as a persistent shell workspace.
  • You need a full process manager: the fleet’s lifetime is bounded by the daemon’s.

Operational limits

  • The fleet's lifetime is bounded by the daemon's: the daemon process is the single point of failure.
  • Commands are executed through the client's non-interactive shell ($SHELL -c, or /bin/sh when SHELL is unset), so functions and aliases defined in ~/.zshrc are not available.
  • Only one client can be connected to the daemon at a time.

See Operational constraints for shutdown and signal mechanics.

About

A fleet-view supervisor for concurrent shell commands

Resources

Readme
GPL-3.0 license
Activity

Stars

5 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.