barq-term

<h1 align="center">⚡ Barq</h1> <p align="center"> <strong>The AI-native macOS terminal. Native Swift. Zero lag. Built for agents.</strong> </p> <p align="center"> <em>برق — "lightning", and the old Arabic word for the telegraph:<br>commands carried over wires to distant machines. That's what Barq does, with an AI operator.</em> </p> --- Barq is a modern terminal emulator and connection manager for macOS, written in **pure Swift** (SwiftUI + [SwiftTerm](https://github.com/migueldeicaza/SwiftTerm)). No Electron, no web views, no lag. It is built AI-first around three ideas: 1. **Agents are users too.** Barq ships an MCP server — any AI agent (Claude Desktop, Claude Code, any MCP client) can discover your hosts, open sessions, run commands, and transfer files, gated by per-profile permission chips. 2. **The Context Vault.** A system-wide store for the variables that make up your working context — device IPs, endpoints, tokens, deploy keys. Values live in the macOS Keychain. Agents can *discover* every variable, but what they can *read* is your call, per variable: **open**, **ask-me-first**, or **secret** — where secrets are *usable* inside commands (`${BARQ:DEPLOY_KEY}`) but never revealed in plaintext. Every agent access is audited. 3. **Local-first AI.** The built-in assistant runs on **Ollama** by default — private, free, on your machine. Drop in an **OpenRouter** key to use frontier models instead. ⌘K turns plain English into commands; the AI panel sees your session and explains failures. ## Features ### Terminal - Native SwiftTerm emulator, true color, crisp CoreGraphics rendering - Tabs, **split panes** (⌘D / ⇧⌘D), **tear-off windows** (⇧⌘N) - **Tab groups** — colored, collapsible groups that auto-form from a profile's tag; drag tabs between groups, rename/recolor, collapse - **Command palette** (⇧⌘P) and **global search** (⇧⌘F) across every session's scrollback - **⌘F find**, middle-click paste, tab rename, live theming - **Broadcast input** — type once, send to every pane in a tab - **Session recording** to asciinema v2 `.cast` - 6 built-in themes (Catppuccin Mocha/Latte, Dracula, Nord, Tokyo Night, Solarized Dark) ### Connections - **SSH** — agent / password / identity-file / pasted-key auth (Browse to pick a key), agent forwarding, custom `-o` options, jump hosts (ProxyJump), **Cloudflare Access**, port forwarding (-L/-R/-D SOCKS5), keep-alives, legacy SCP mode for BusyBox/dropbear devices - **Quick Connect** (⇧⌘K) for ad-hoc `user@host:port`, and font zoom (⌘+/⌘−/⌘0) - **Serial** — raw termios, all baud rates, data/stop bits, parity - **Telnet** — built-in client with IAC negotiation (no system telnet needed) - **Local shells** with cwd tracking; **SFTP** session tabs - **Chrome SOCKS launcher** — open a proxied Chrome with include/exclude host filtering - **Drag-and-drop SCP upload** — drop files onto an SSH terminal - Profiles with tags, sidebar grouping, search, custom actions; JSON and `~/.ssh/config` import/export - **Session restore** on relaunch; **`barq://` URL scheme** and Finder "Open folder in Barq" - Passwords and keys never touch disk in plaintext — everything is Keychain-backed ### AI - **⌘K composer** — describe what you want; get the command; run or insert it - **AI panel** (⇧⌘A) — chat with full session context; proposed commands are one-click runnable - **⌘E** — explain the last output/error - Ollama auto-detection, or OpenRouter with any model id ### MCP — 17 tools for agents `list_profiles` · `add_profile` · `remove_profile` · `connect` · `list_sessions` · `get_status` · `run_command` · `run_on_tag` · `send_input` · `read_output` · `disconnect` · `list_serial_ports` · `upload_file` · `download_file` · `vault_list` · `vault_get` · `vault_set` Safety model: - Agents can only connect to profiles whose **AI chip** you switched on - Agent-created profiles start with AI access **off** - Vault reads honor per-variable policy; **secret** values are substituted into commands server-side and never returned to the agent - **Guardrails**: destructive commands (rm -rf, mkfs, force push, DB drops, pipe-to-shell…) require a native approval prompt - **`run_on_tag`**: fleet operations across every AI-allowed host carrying a tag - Full audit log of every agent access in the Vault window ## Install **Homebrew (recommended — handles updates via `brew upgrade`):** ```bash brew tap awaistechnologist/barq brew install --cask barq-term # add --no-quarantine to skip the Gatekeeper prompt ``` **Direct download:** grab the latest `Barq-<version>.dmg` from [Releases](https://github.com/awaistechnologist/barq-term/releases), open it, and drag Barq to Applications. Barq notifies you in-app when a new version ships. > Barq is currently ad-hoc signed (not notarized). On first launch macOS may warn: > **right-click Barq → Open**, or **System Settings → Privacy & Security → Open Anyway**. ## Build from source ```bash git clone https://github.com/awaistechnologist/barq-term && cd barq-term swift run Barq # run it ./scripts/make-app.sh 0.7.1 && ./scripts/make-dmg.sh 0.7.1 # or build the DMG ``` Register the MCP server (Settings → MCP → one click), or manually: ```bash claude mcp add barq /path/to/Barq.app/Contents/MacOS/barq-mcp ``` For local AI: install [Ollama](https://ollama.com), `ollama pull llama3.2`, done — Barq finds it automatically. ## Example: an agent using the vault ``` You (to Claude): "Check disk usage on the staging box" Claude → vault_list # discovers STAGING_IP ("staging server address", open) Claude → connect(profile_name: "staging") Claude → run_command(session_id: "1", command: "df -h ${BARQ:STAGING_IP}...") # Barq expands the variable ``` If the variable were policy `approval`, you'd get a native prompt before the read; if `secret`, the agent could use it but never see it. ## Development TDD is the house style — the logic layer is fully covered and the suite runs in ~2s: ```bash ./scripts/test.sh # full suite (184 tests / 32 suites) ./scripts/test.sh --filter VaultStore # one suite swift build # app + barq-mcp ``` Requirements: macOS 13+, Swift 6 toolchain (Command Line Tools are enough — no Xcode needed). ## Roadmap Shipped recently: Barq Home + omni-bar, in-app model advisor + one-click Ollama, DMG + Homebrew cask + in-app update notifier (0.5–0.7); tab groups (0.3). Next: - [ ] Developer ID signing + notarization (drops the Gatekeeper prompt; enables Sparkle self-update) - [ ] Block-based output (AI-addressable command/output units) - [ ] SFTP dual-pane browser (beyond the interactive SFTP tab) - [ ] Runbooks: record a session → parameterized, replayable procedure - [ ] Read-only agent mode and per-profile command allowlists ## License [PolyForm Noncommercial 1.0.0](LICENSE) — free for personal and non-commercial use. For commercial use, please reach out via the repo. "Barq" and its logo are trademarks of the author.