Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/bastndev/f1/llms.txt

Use this file to discover all available pages before exploring further.

The CLI Hub is the bottom-panel webview (f1.myCli) that hosts fully-functional embedded terminals directly inside VS Code. Each terminal runs a real AI coding agent process — Claude Code, Codex, Cursor, and more — rendered by xterm.js. You never leave the editor to interact with your agents, and every session persists independently so you can run multiple agents side-by-side on the same codebase.

Opening CLI Hub

Press F1 (keybinding: f1.myCli.smartFocus) to open and focus the CLI Hub panel at any time. If the panel is already visible, F1 moves keyboard focus directly into the active terminal so you can start typing immediately.
CLI Hub uses xterm.js v6 with the xterm-addon-fit addon for terminal rendering. The fit addon automatically resizes each terminal’s column and row dimensions whenever the panel is resized, keeping the PTY and the display in sync.

Managing Sessions

CLI Hub supports multiple concurrent agent sessions in a single panel. Each session is an independent terminal with its own scrollback buffer — switching sessions is instant because the content is retained in memory.
ActionShortcut
Create a new sessionAlt++
Close the active sessionAlt+-
Switch to the next sessionTab
Switch to the previous sessionShift+Tab
Open the CLI selectorCapsLock
Jump directly to agent 1–919
When you close the last remaining session, the panel returns to the launcher so you can pick a new agent.

Architecture

Sessions run via node-pty inside a dedicated pty-host.js process that is spawned with system Node rather than Electron-as-Node. This separation is intentional: node-pty is a native binding compiled against a specific Node ABI, and running it inside Electron’s bundled runtime causes silent segfaults. The pty-host communicates with the extension host over an IPC channel, forwarding terminal output back to the xterm.js canvas in the webview.
Extension Host (Node)
  └── CliSessionManager
        └── spawns pty-host.js (system Node)
              └── node-pty  →  IPC  →  CliSessionManager
                                             └── postMessage → xterm.js (webview)

Built-in Tools

Five tools are available directly inside the CLI Hub panel, each mapped to a keyboard shortcut:
ToolShortcutPurpose
Prompt ComposerShift+F1Write rich prompts with @-file mentions, image paste, live spellcheck, and auto-translation
TranslatorShift+F2Translate any terminal text selection inline
Status / UseShift+F3Per-agent usage and status view
KeymapsShift+F4In-panel keyboard shortcut reference for the active CLI
CommandsAlt+F1Searchable slash-command palette for the active agent

Explore CLI Hub

Agents

Browse the 9 built-in agents, their commands and slugs, fuzzy aliases, and how to launch any custom CLI.

Prompt Composer

Write better prompts with file mentions, image paste, live spellcheck in 4 languages, and auto-translation.

Tools

Translator, Status/Use, Keymaps, Commands palette, and Voice read-aloud — all built into every session.

Quickstart

Install F1 and launch your first AI agent session in under a minute.

Build docs developers (and LLMs) love