CLI + TUI for solo AI engineers inspecting bare-metal AI infrastructure.
_{Host · GPU · Docker · LLM · DB — correlated, read-only, scriptable.}

Website · Install · Quick start · Commands · Docs · Roadmap

---

bareai answers one question on a single machine: what is this box doing right now?

It collects host resources, GPUs, Docker, local LLM runtimes (Ollama, vLLM, SGLang, Triton, …), and local databases, correlates them, and presents the result as human tables, JSON, or a live terminal dashboard.

Mode	Inspect / probe by default; confirm-gated fixes via bareai do (Docker-scoped)
Persona	One engineer, one machine (SSH or local)
Platforms	Linux, macOS, Windows
GPUs	NVIDIA, AMD, Apple Silicon (degrades gracefully when absent)
Output	CLI tables · live TUI · --json · MCP tools for agents

Collectors are optional: missing Docker, GPU drivers, or LLM runtimes degrade gracefully. Commands still exit 0 and record a skipped reason.

Host + GPU + Docker + LLM + DB  →  Snapshot  →  CLI / TUI / JSON / MCP

---

Install

macOS / Linux — no sudo, installs to ~/.local/bin:

curl -fsSL https://raw.githubusercontent.com/baselhusam/bareai-cli/main/scripts/install.sh | bash
source ~/.zshrc && bareai version

Homebrew — trust the tap once, then install:

brew tap baselhusam/tap
brew trust baselhusam/tap
brew install bareai
bareai version

Windows:

winget install baselhusam.bareai

APT, PowerShell script, manual download, completions, troubleshooting: docs/install.md

---

Quick start

bareai status                 # one-screen summary
bareai inspect                # full correlated report
bareai inspect --json | jq .  # machine-readable snapshot
bareai doctor --share         # paste-friendly report for issues/chat
bareai mcp                    # MCP server for Cursor / Claude (stdio)

On a TTY, bare bareai launches the dashboard. In pipes/CI it prints help; bareai watch falls back to status.

---

Commands

Command	Purpose
(none) / watch	Live TUI dashboard
status	Host + infrastructure summary
gpu	GPU inventory and metrics
docker	Containers, images, volumes
llm	Discovered inference servers
db	Local databases (Postgres, Redis, Mongo, …)
probe	One-hit smoke tests
inspect	Full correlated report
doctor	Ranked diagnostics + suggested actions
do	Confirm-gated fixes tied to findings
mcp	MCP server for coding agents (stdio)
config path	Resolved config file path
version	Build metadata
completion	Shell completions

Full reference with flags and examples: docs/commands.md

---

Website

Product landing (GitHub Pages): baselhusam.github.io/bareai-cli — source in docs/site/.

Enable under Settings → Pages: Deploy from a branch → main → /docs.

Documentation

Guide
Install	Scripts, Homebrew, winget, APT
Configuration	Config YAML, flags, env vars
Commands	CLI reference
Interactive TUI	Tabs and keybindings
JSON & snapshot	--json output model
Agents & MCP	MCP tools and agent contract
Actions (bareai do)	Confirm-gated finding-scoped fixes
Platforms	Linux / macOS / Windows matrix
Workflows	Common recipes
Development	Build, test, lint
Branding	Logos and palette
Roadmap	Phases and status

---

License

MIT — see LICENSE.