Vector Windows — Terminal Agent-First
prateekraj3711-alt/vector-windows
Terminal nativo para agentes IA no Windows com abas agent-first
Ver no GitHubPort Windows de um terminal orientado por agentes IA (Claude Code, Cursor Agent, GitHub Copilot, etc). Cada aba inicia dentro de um agente escolhido, com suporte a múltiplos perfis Claude, divisão de painéis, visualizador de arquivos e integração com editores.
Instalação
npx convez-ai prateekraj3711-alt/vector-windows1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Desenvolvimento assistido por Claude Code ou Cursor Agent no Windows
- Gerenciamento de múltiplas contas Claude por projeto/pasta
- Workflows de codificação com divisão de painéis e previsualizador de arquivos
Veredito

Ferramenta técnica sólida que traz a experiência agent-first para Windows com UX bem pensada (abas, painéis, perfis). Restrição de licença não-comercial limita adoção corporativa, mas valor real para dev individual e pequenas equipes.
README
A tradução para o português deste README ainda está na fila.
Vector (Windows port)
An agent-first terminal. Every tab starts inside your favorite coding agent (Claude Code, Codex, Cursor Agent, GitHub Copilot CLI, Aider, Gemini, Amazon Q, OpenCode, Crush, Goose, Amp, Plandex, Continue, Qodo — or a raw shell), not a shell prompt.
About this repository. This is a Windows port of avram19/vector, which is macOS (Apple Silicon) only upstream. All original work and copyright belong to the upstream author; this fork adds Windows platform support (PTY/ConPTY, path handling, agent-binary resolution, file-manager/editor integration, credential reading) and is redistributed under the same PolyForm Noncommercial License 1.0.0. See
WINDOWS_PORT.mdfor the port scope and progress.
Table of Contents
- Features
- Shortcuts
- Claude Profiles (in depth)
- Install on Windows
- Install on macOS
- Build from source
- Add a custom agent
- License
Features
Agent-native tabs
Ctrl+Shift+T (⌘T on macOS) opens a new tab already inside an agent, scoped to a project folder you pick.
Claude Profiles
Map folders to separate Claude accounts (CLAUDE_CONFIG_DIR under the hood). Open ~/work with your work account, ~/personal with your personal one — no more /logout → /login. Read more.
Pane splits
Split a tab into a grid of agent panes with Ctrl+Shift+D / Ctrl+Shift+E (⌘D / ⌘⇧D on macOS), drag dividers to resize, drag panes between tabs. Each pane runs its own agent.
File Previewer
Ctrl-click (⌘-click on macOS) any file path printed by an agent to open a read-only preview in a side pane on the same tab. Supports Markdown (with embedded Mermaid diagrams), standalone Mermaid, syntax-highlighted code (js/ts/py/rs/rb and other common formats), PDF, and images. Ctrl+Shift-click pins a second preview for side-by-side compare. Right-click any path or preview pane for Reveal in File Explorer, Open in default app, or Copy path.
Sidebar — files & worktrees
A collapsible sidebar with two tabs, both scoped to the focused tab's project:
- Files — VSCode-style tree of the project root with hidden-files toggle. Click to open a preview,
Ctrl+Shift-click (⌘⇧-click on macOS) to pin a second preview. Right-click for Reveal in File Explorer, Open in default app, Open in installed editor (VS Code / Cursor / Zed / Windsurf / WebStorm / IntelliJ / PyCharm / Sublime), or Copy path. Tree refreshes live as the agent writes files. - Worktrees — every git repo discovered under the project, grouped by repo. Each worktree expands to show Uncommitted and Committed (vs base) changes. Click a change to open a unified diff with syntax highlighting in the preview pane. Toggle between flat and tree views from the search bar; both persist across restarts. Right-click a worktree for Reveal / Open / Open in editor.
Sidebar width, active tab, collapsed state, hidden-files toggle, and worktrees view mode all persist via ~/.config/vector/ui.toml.
Resume Claude sessions
The project picker surfaces the session history for the folder you chose, so you can jump back into a conversation instead of starting fresh.
Auto-detect installed agents
Scans PATH for known CLIs; only shows ones you actually have.
Project picker
Remembers recents, one picker per new tab.
Per-tab agent swap
Change agent from the topbar dropdown; session restarts cleanly.
Claude usage meter
Live 5-hour and 7-day usage bars in the topbar when a Claude pane is active.
Terminal context menu
Right-click a URL or file path to Open / Reveal in Finder / Copy. Right-click a selection to Copy as plain text (strips NBSP, zero-width chars, and Claude's indent gutter so pasting into Slack or docs doesn't look weird).
Bell notifications
When an agent emits \x07 (asking for input) and the tab is inactive or the window is unfocused, the tab is highlighted and a macOS notification fires.
Theme
Dark or Solarized Light.
Tab layout
Horizontal on top, or vertical sidebar.
Per-agent icons and chips
Per-agent icons and chips in every tab.
Shortcuts
On Windows, bare Ctrl is left for the terminal (so Ctrl+C, Ctrl+D,
Ctrl+R, Ctrl+W, etc. reach your agent), so app actions use Ctrl+Shift,
tab switching uses Alt, and pane focus uses Ctrl+Alt.
| Action | Windows | macOS |
|---|---|---|
| New tab (opens project picker) | Ctrl+Shift+T | ⌘T |
| Close active pane | Ctrl+Shift+W | ⌘W |
| Split pane right / down | Ctrl+Shift+D / Ctrl+Shift+E | ⌘D / ⌘⇧D |
| Focus adjacent pane | Ctrl+Alt+←/→/↑/↓ | ⌘⌥←/→/↑/↓ |
| Reload (restart) active agent | Ctrl+Shift+R | ⌘⇧R |
| Switch tab | Alt+1…Alt+9 | ⌘1…⌘9 |
| Next / previous tab | Ctrl+Tab / Ctrl+Shift+Tab | ⌃⇥ / ⌃⇧⇥ |
| Toggle companion shell (active pane) | `Ctrl+`` | `⌃`` |
| Command switcher | Ctrl+Shift+K | ⌘K |
| Open Settings | Ctrl+, | ⌘, |
| Font size up / down / reset | Ctrl+= / Ctrl+- / Ctrl+0 | ⌘= / ⌘- / ⌘0 |
| Multi-line input (Claude Code) | Shift+Enter | ⇧↵ |
| Cursor to line start / end (while typing) | Home / End | ⌘← / ⌘→ |
| Cursor back / forward one word | Alt+← / Alt+→ | ⌥← / ⌥→ |
| Delete previous word | Ctrl+Backspace | ⌥⌫ |
Claude Profiles (in depth)
If you juggle two Claude accounts — say personal and work — the usual flow is painful: Claude Code keeps a single login in ~/.claude/, so switching means /logout then /login every time you move between folders.
Vector solves this by mapping folders → profiles, where each profile is an isolated Claude home (~/.claude-profiles/<id>/) injected via CLAUDE_CONFIG_DIR when a Claude session starts in a matched folder.
- Open Settings (
Ctrl+,, or⌘,on macOS) → Claude Profiles → Add profile. - Pick a name, the folders that should use it, and (under Advanced) a Seed from source — defaults to
~/.claude, or point it at~/.claude-work/ any existing Claude home. Credentials,settings.json, andprojects/history are copied over so the new profile starts with your real state instead of a blank install. - macOS stores Claude credentials in Keychain by default; seeding copies everything else but the new profile will still prompt
/loginonce — after that it sticks. - Each Claude tab shows a small pill with the active profile. Click it to override for just that tab (ephemeral) or jump to Manage profiles.
Folders not mapped to any profile continue to use your existing ~/.claude/ — upgrading Vector never touches your default login.
Install on Windows
Requirements: Windows 10/11 (x64). The Microsoft Edge WebView2 runtime is required — it ships with current Windows 11 and is auto-installed by the setup if missing.
- Go to the Releases
page and download one of:
Vector_<version>_x64-setup.exe— NSIS installer (recommended; per-user, no admin needed)Vector_<version>_x64_en-US.msi— MSI installer (for managed/Group-Policy deploys)
- Run the installer.
- SmartScreen warning: because the build is not yet code-signed, Windows SmartScreen will show "Windows protected your PC." Click More info → Run anyway to proceed. (This goes away once the app is signed with an OV/EV certificate.)
- Launch Vector from the Start menu.
Vector auto-detects any AI CLIs already on your PATH (Claude Code, Codex,
Gemini, …). Install at least one — e.g. Claude Code via npm i -g @anthropic-ai/claude-code — and it appears in the new-tab agent list.
See Shortcuts for the Windows key bindings. Bare terminal
keys (Ctrl+C, Ctrl+D, Ctrl+R, …) pass straight through to your agent;
app actions use Ctrl+Shift, tab switching uses Alt.
Install on macOS
Download the latest .dmg from the
upstream Releases page, drag
Vector into /Applications, and open it. Because the build is unsigned,
Gatekeeper blocks it the first time — bypass with right-click → Open → Open,
or xattr -dr com.apple.quarantine /Applications/Vector.app.
Build from source
Requirements:
- Rust (stable, MSVC host on Windows) — https://rustup.rs
- Node 20+
- Windows: Visual Studio 2022 C++ build tools (the Desktop development with C++ workload) + a Windows 10/11 SDK, and the WebView2 runtime.
- macOS: Xcode command-line tools. Linux: the usual
webkit2gtk/gtkdev packages.
npm install
npm run tauri dev # dev build with hot reload
npm run tauri build # release build + installers
On Windows, npm run tauri build produces, under
src-tauri/target/release/bundle/:
nsis/Vector_<version>_x64-setup.exemsi/Vector_<version>_x64_en-US.msi
To produce signed updater artifacts locally, set the signing env vars before building (CI sets these from repo secrets automatically):
$env:TAURI_SIGNING_PRIVATE_KEY = Get-Content "$env:USERPROFILE\.vector-windows-updater.key" -Raw
$env:TAURI_SIGNING_PRIVATE_KEY_PASSWORD = "<your key password>"
npm run tauri build
Releasing (automated)
Pushing a version tag builds and publishes the Windows installers
automatically via .github/workflows/release-windows.yml:
git tag v0.3.4-win.1
git push origin v0.3.4-win.1 # → GitHub Actions builds + signs + creates the Release
The workflow can also be run manually from the Actions tab (provide a tag).
It signs the updater bundle with the repo secrets TAURI_SIGNING_PRIVATE_KEY
and TAURI_SIGNING_PRIVATE_KEY_PASSWORD, and uploads the NSIS/MSI installers
plus latest.json (consumed by the in-app auto-updater).
Add a custom agent
Drop a TOML file at %APPDATA%\vector\config.toml (Windows) or
~/.config/vector/config.toml (macOS/Linux):
default = "claude"
[agents.myagent]
label = "My Custom Agent"
command = ["my-cli", "--flag"]
[agents.myagent.env]
MY_API_KEY = "..."
Vector merges this with the built-in list on every launch.
License
Source-available under the PolyForm Noncommercial License 1.0.0.
Anyone is free to read, modify, redistribute, and use Vector for non-commercial purposes (personal use, research, hobby projects, internal use at a nonprofit, etc.). Commercial use requires a separate license — open an issue or contact the maintainer.
Vector bundles and invokes third-party CLIs (Claude Code, Codex, Cursor Agent, Copilot CLI, etc.) — those are governed by their own licenses and terms of service.