argus

package module
v0.0.0-...-9714570 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 14, 2026 License: MIT Imports: 1 Imported by: 0

README

Argus

Watch and control all your AI agents.

Run more than one AI coding agent and they scatter across tmux panes and machines. Argus pulls them into one view: which are working, which are stuck on a prompt, which just finished. Read transcripts, watch and type into a session, answer prompts, spawn/interrupt/kill — without leaving the TUI.

Works with Claude Code, Codex, and Antigravity — side by side in one view.

Start local in a terminal. Scale to a fleet across machines. Get a push notification on your phone when a session needs you.

[!IMPORTANT] 📖 Read the full documentation at argus.muniftanjim.dev — installation, setup guides, the TUI, the mobile app, and configuration.

Highlights

  • Multi-agent — Claude Code, Codex, and Antigravity, in one session list.
  • Zero-setup discovery — finds agent sessions in tmux. No per-session config.
  • Don't use tmux? — argus spawn wraps an agent in tmux for you.
  • Live status — working / waiting / idle / dead, from each agent's hooks.
  • Transcripts — full conversation, foldable, drill into tool calls.
  • Live screen — watch a session's terminal and type into it.
  • Lifecycle control — spawn, interrupt, kill, answer prompts in place.
  • Fleet mode — aggregate machines, watch them all from one TUI.
  • Mobile app — Android companion with Push Notification, even when closed.

License

Licensed under the MIT License. Check the LICENSE file for details.

Documentation

Overview

Package argus embeds shared assets. It lives at the module root because embed paths can only descend from the embedding file's directory (needs app/).

Index

Constants

This section is empty.

Variables

View Source 
var IconPNG []byte

IconPNG is the argus app icon, used to brand desktop notifications.

Functions

This section is empty.

Types

This section is empty.

Source Files

View all Source files

Directories

Path Synopsis
cmd
argus command
Command argus is the terminal UI client.
 Command argus is the terminal UI client.
argus/completion
internal
adapter
Package adapter defines the interface between argus's core and AI-coding-tool integrations such as Claude Code, Codex, or Antigravity.
 Package adapter defines the interface between argus's core and AI-coding-tool integrations such as Claude Code, Codex, or Antigravity.
adapter/antigravity
Package antigravity is the argus adapter for Google Antigravity's terminal agent (agy).
 Package antigravity is the argus adapter for Google Antigravity's terminal agent (agy).
adapter/claudecode
Package claudecode is the argus adapter for Claude Code.
 Package claudecode is the argus adapter for Claude Code.
adapter/claudecode/parser
Package parser reads and structures Claude Code session transcripts (JSONL).
 Package parser reads and structures Claude Code session transcripts (JSONL).
adapter/codex
Package codex is the argus adapter for OpenAI Codex CLI.
 Package codex is the argus adapter for OpenAI Codex CLI.
adapter/hookdecision
Package hookdecision renders a user's permission answer into hookSpecificOutput decision JSON.
 Package hookdecision renders a user's permission answer into hookSpecificOutput decision JSON.
adapter/hookset
Package hookset manages argus's command hooks inside a tool's hook config without disturbing the user's hooks.
 Package hookset manages argus's command hooks inside a tool's hook config without disturbing the user's hooks.
adapters
Package adapters is the registry of agent adapters argus ships with.
 Package adapters is the registry of agent adapters argus ships with.
api
Package api implements argus's client↔node protocol: newline-delimited JSON-RPC 2.0 over a stream connection.
 Package api implements argus's client↔node protocol: newline-delimited JSON-RPC 2.0 over a stream connection.
bundle
Package bundle reads and writes the .argus session export archive: a gzipped tar of a manifest plus the session's raw tool files under a "root/" subtree.
 Package bundle reads and writes the .argus session export archive: a gzipped tar of a manifest plus the session's raw tool files under a "root/" subtree.
clienttoken
Package clienttoken manages per-client gateway tokens: one long-lived random secret per paired device, each its own file so a device can be revoked without rotating the shared gateway token.
 Package clienttoken manages per-client gateway tokens: one long-lived random secret per paired device, each its own file so a device can be revoked without rotating the shared gateway token.
config
gateway
Package gateway aggregates sessions from many node sources into one merged view and routes control calls back to the owning node.
 Package gateway aggregates sessions from many node sources into one merged view and routes control calls back to the owning node.
gitmeta
Package gitmeta derives lightweight git metadata (branch, user identity) for a directory.
 Package gitmeta derives lightweight git metadata (branch, user identity) for a directory.
histcache
Package histcache is a disk-backed per-session metadata cache shared by the agent adapters' history list views.
 Package histcache is a disk-backed per-session metadata cache shared by the agent adapters' history list views.
logbuf
Package logbuf is a bounded, concurrency-safe in-memory ring of log lines, used by the TUI to tail the embedded node's output in a Logs tab.
 Package logbuf is a bounded, concurrency-safe in-memory ring of log lines, used by the TUI to tail the embedded node's output in a Logs tab.
logger
Package logger is argus's logging entry point: it installs the global slog handler from config and exposes scoped loggers.
 Package logger is argus's logging entry point: it installs the global slog handler from config and exposes scoped loggers.
logger/log
node
Package node is the in-process core behind argusd: registry, Claude Code discoverer over both tmux servers, and the JSON-RPC API server.
 Package node is the in-process core behind argusd: registry, Claude Code discoverer over both tmux servers, and the JSON-RPC API server.
push
Package push delivers out-of-band notifications to paired mobile devices so the gateway can reach a phone whose app is backgrounded (the live WebSocket only delivers while the app is open).
 Package push delivers out-of-band notifications to paired mobile devices so the gateway can reach a phone whose app is backgrounded (the live WebSocket only delivers while the app is open).
registry
Package registry holds argus's live model of all known sessions and publishes change events to subscribers (clients, the TUI).
 Package registry holds argus's live model of all known sessions and publishes change events to subscribers (clients, the TUI).
session
Package session defines argus's transport- and tool-agnostic model for every AI coding tool session it discovers or manages.
 Package session defines argus's transport- and tool-agnostic model for every AI coding tool session it discovers or manages.
shell
spawn
Package spawn holds helpers shared between the sessions.spawn RPC (node) and the `argus spawn` CLI command, so both derive identical tmux session names.
 Package spawn holds helpers shared between the sessions.spawn RPC (node) and the `argus spawn` CLI command, so both derive identical tmux session names.
sshconn
Package sshconn provides a net.Conn that tunnels through a managed `ssh -W` child process.
 Package sshconn provides a net.Conn that tunnels through a managed `ssh -W` child process.
tmux
Package tmux is a thin wrapper around the tmux CLI for discovering, reading, controlling, and managing panes.
 Package tmux is a thin wrapper around the tmux CLI for discovering, reading, controlling, and managing panes.
transcript
Package transcript defines argus's tool-agnostic display model for a coding session's conversation: the chunk/item types shipped over RPC and rendered by clients.
 Package transcript defines argus's tool-agnostic display model for a coding session's conversation: the chunk/item types shipped over RPC and rendered by clients.
tui
Package tui is argus's Bubble Tea terminal client: session list, live registry events, transcript view, and screen passthrough for direct pane interaction.
 Package tui is argus's Bubble Tea terminal client: session list, live registry events, transcript view, and screen passthrough for direct pane interaction.
tunnel
Package tunnel manages a tunnel-provider CLI (e.g.
 Package tunnel manages a tunnel-provider CLI (e.g.
util

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.