Infraware Terminal#

An AI-native terminal for cloud infrastructure operations, with an integrated agentic engine for DevOps assistance. Prefix any command with ? to ask questions in natural language.

Early Stage: This project is under active development. APIs, features, and behavior may change without notice. Contributions and feedback are welcome!

Features#

• Natural language queries — prefix any command with ? to ask the AI agent (e.g., ? how do I revert the last git commit)
• Human-in-the-loop — the agent proposes shell commands for your approval before executing them
• Incident investigation pipeline — structured multi-phase investigation with post-mortem reports and remediation plans
• Tabbed terminal — multiple tabs and split panes via egui_tiles
• VTE terminal emulation — full ANSI/xterm-256color support
• Docker sandbox — optionally run commands inside a disposable Docker container
• Arena mode — incident investigation challenges in preconfigured Docker environments
• Session memory — the agent remembers facts about you and your environment across sessions

Quick Start#

Prerequisites#

• Rust 1.94+ (edition 2024) — install via rustup
• Supported platforms: macOS (arm64, x86_64), Linux (x86_64, aarch64). Windows is not yet supported.
• Anthropic API key for the AI agent (optional — you can try the terminal without one using mock mode)

Linux only:

sudo apt install -y pkg-config libssl-dev libxcb-shape0-dev libxcb-xfixes0-dev

Build and Run#

git clone https://github.com/Infraware-dev/infraware-terminal.git
cd infraware-terminal

# Try it immediately — no API key needed
ENGINE_TYPE=mock cargo run

# Or, to use the AI agent: set your Anthropic API key
cp .env.example .env
# Edit .env and paste your key after ANTHROPIC_API_KEY=
cargo run

# Or pass the API key directly
cargo run -- --api-key sk-ant-...

Use the AI Agent#

In the terminal, prefix with ? for natural language queries:

? show me running Docker containers
? list files larger than 100MB in this directory
? how do I revert the last git commit

The agent will propose commands for your approval before running them.

Configuration#

Configuration is done via environment variables (or a .env file). See .env.example for all options.

CLI Flags#

cargo run -- --api-key <KEY>                    # Pass API key directly
cargo run -- --log-level debug                  # Set log level

# Docker sandbox (requires pty-test_container feature)
cargo run --features pty-test_container -- --use-pty-test-container
cargo run --features pty-test_container -- --use-pty-test-container --pty-test-container-image ubuntu:24.04

# Arena mode (requires arena feature + Docker)
cargo run --features arena -- --arena the-502-cascade

Keyboard Shortcuts#

Architecture#

Infraware Terminal is a single Rust binary that combines a GPU-accelerated terminal (egui/eframe) with an in-process agentic LLM engine.

+---------------------------------------------------+
| infraware-terminal                                |
|                                                   |
|  +-------------+     +------------------------+  |
|  | Terminal UI  |     | Agent (trait)           |  |
|  | (egui)      |<--->| +--------+ +---------+ |  |
|  +------+------+     | | Mock   | | Rig     | |  |
|         |            | | Agent  | | Agent   | |  |
|    +----v----+       | +--------+ +----+----+ |  |
|    |   PTY   |       +----------------+-------+  |
|    | Session |                        |           |
|    +----+----+                        |           |
|    +----v----+                 +------v------+    |
|    |  VTE    |                 | Anthropic   |    |
|    | Parser  |                 | API         |    |
|    +---------+                 +-------------+    |
+---------------------------------------------------+

For a detailed architecture description, see docs/architecture.md.

Documentation#

Feature Flags#

Development#

cargo build                          # Build
cargo test                           # Run tests
cargo +nightly fmt --all             # Format (requires nightly for rustfmt.toml rules)
cargo clippy -- -D warnings          # Lint (CI-strict mode)
cargo watch -x run                   # Watch mode (requires cargo-watch)
LOG_LEVEL=debug cargo run            # Run with debug logging

Contributing#

See CONTRIBUTING.md for guidelines.

License#

Licensed under the Apache License, Version 2.0.

Copyright 2026 Infraware S.R.L.