AUTO

module
v0.1.0 Latest Latest
Warning

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

Go to latest
Published: Jan 6, 2026 License: Apache-2.0

README

AUTO - Agent Unified Terminal Orchestrator

A terminal user interface for monitoring and controlling dozens of AI agent sessions (opencode and other pluggable agents) from a single unified dashboard.

Vision

AUTO provides at-a-glance visibility into all active AI agent sessions, enabling operators to:

  • Monitor real-time status of dozens of concurrent agent sessions
  • Receive alerts when agents error, hit context limits, or complete tasks
  • Switch seamlessly between agent sessions
  • View aggregated statistics across all agents
  • Control agent lifecycle (start, pause, resume, terminate)

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                         AUTO TUI                                │
├─────────────┬─────────────────────────────┬────────────────────┤
│  Agent List │      Session Viewport       │   Stats/Alerts     │
│             │                             │                    │
│  ● agent-1  │  [Active session output]    │  Total: 42         │
│  ○ agent-2  │                             │  Active: 38        │
│  ◉ agent-3  │                             │  Errored: 2        │
│  ● agent-4  │                             │  Complete: 2       │
│  ...        │                             │                    │
└─────────────┴─────────────────────────────┴────────────────────┘

Core Features

Phase 1: Foundation
  • Session discovery and monitoring for opencode
  • Real-time status updates
  • Basic TUI with agent list and session view
Phase 2: Control
  • Session switching
  • Alert system for errors/completions
  • Input forwarding to active session
Phase 3: Analytics
  • Statistics dashboard
  • Session history and logs
  • Performance metrics
Phase 4: Extensibility
  • Plugin system for other agent types
  • Web interface
  • API for external integrations

Tech Stack

  • Language: Go
  • TUI Framework: Bubbletea (Charm.sh ecosystem)
  • Styling: Lipgloss
  • Components: Bubbles (tables, lists, viewports)

Project Structure

auto/
├── cmd/
│   └── auto/           # Main entrypoint
├── internal/
│   ├── tui/            # Terminal UI components
│   │   ├── app.go      # Main application model
│   │   ├── views/      # Different screens/views
│   │   └── components/ # Reusable UI components
│   ├── agent/          # Agent abstraction layer
│   │   ├── agent.go    # Agent interface
│   │   ├── registry.go # Agent type registry
│   │   └── providers/  # Concrete agent implementations
│   │       └── opencode/
│   ├── session/        # Session management
│   │   ├── session.go  # Session model
│   │   ├── manager.go  # Session lifecycle
│   │   └── store.go    # Session persistence
│   ├── monitor/        # Status monitoring
│   │   ├── monitor.go  # Monitor coordinator
│   │   ├── watcher.go  # File/process watchers
│   │   └── alerts.go   # Alert generation
│   └── config/         # Configuration
├── pkg/
│   └── api/            # Public API (future web interface)
├── configs/            # Default configurations
└── docs/               # Documentation

Getting Started

# Build
go build -o auto ./cmd/auto

# Run
./auto

# Run with config
./auto --config ~/.config/auto/config.yaml

License

MIT

Directories

Path Synopsis
cmd
auto command
internal
agent
Package agent defines the core agent interface and types
Package agent defines the core agent interface and types
agent/providers/opencode
Package opencode provides an agent provider for opencode sessions
Package opencode provides an agent provider for opencode sessions
alert
Package alert handles multi-channel alerting
Package alert handles multi-channel alerting
config
Package config handles application configuration
Package config handles application configuration
plugin
Package plugin provides an extensible plugin system for AUTO
Package plugin provides an extensible plugin system for AUTO
session
Package session manages agent sessions
Package session manages agent sessions
store
Package store handles persistent storage using SQLite
Package store handles persistent storage using SQLite
tui
tui/components
Package components provides TUI components
Package components provides TUI components
pkg
api
Package api provides HTTP/WebSocket API for AUTO
Package api provides HTTP/WebSocket API for AUTO

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL