What is Neeko

When you're driving multiple projects with AI Agents simultaneously, constantly switching between terminal windows, restarting Agents, and losing context breaks your development flow.

Neeko consolidates all project Agent terminals into a single desktop application: the left sidebar manages projects and Git status, while the right side shows each project's independent terminal — switch projects and your sessions stay alive.

Preview

Main Interface	File Management Panel	Skills Management Panel

Features

• Multi-Project Terminal — Each project binds to an independent PTY terminal, sessions persist across switches, no Agent restarts needed
• WSL Terminals — Browse WSL distributions, select paths, and launch full PTY terminals with Agent auto-launch (Windows only)
• SSH Remote Terminals — Connect to remote servers via password or key-file auth, manage paths, and run Agents remotely with session caching; optionally save credentials for seamless reconnection
• Worktree Terminals — Each Git worktree gets its own independent terminal session with the correct working directory; click any worktree in the sidebar to open or resume its session
• One-Click Agent Launch — Built-in support for opencode, claude-code, gemini, codex, qoder, codebuddy — select and launch; worktree terminals automatically start the project's configured Agent
• Side Terminal Panel — Ctrl+Alt+T opens an independent side terminal next to the Agent terminal, with draggable width; when a worktree terminal is active, the side panel also opens in the worktree directory
• One-Click IDE Launch — Bind an IDE to each project, Ctrl+O or click the icon to open in VSCode / Cursor / GoLand, etc.; IDE icons displayed from built-in SVG/PNG assets
• Git Sidebar — View changed files as a hierarchical tree, switch branches, manage Worktrees without leaving the app; file list auto-refreshes when files change on disk
• Diff Viewer — Click changed files to view diffs in unified or side-by-side mode, with syntax highlighting, word-level diff, and change block navigation
• Theme Sync — Application theme (dark, light, one-dark-pro, claude) automatically syncs to OpenCode TUI config for local, WSL, and SSH remote projects
• Inline Rename — Double-click any branch name or worktree to rename it in place; press Enter to confirm or Escape to cancel
• Session Persistence — Automatically restores project list, Agent, and IDE configs after restart; worktree terminal state is preserved per-project when switching between projects
• Terminal Refresh — Ctrl+R rebuilds the current terminal's DOM from the cached PTY session without losing state
• Keyboard Driven — Ctrl+1~9 jump to projects, Ctrl+Q cycle through, Ctrl+N cycle through main + worktree terminals, Ctrl+O open IDE
• Configurable Shell — Choose or customize terminal Shell in settings, supports zsh / bash / fish / PowerShell, etc.
• Configurable Font — Select terminal font from system fonts with live preview
• Custom Agents — Add custom Agent CLIs and override built-in Agent commands in the Settings panel
• Immersive Interface — One Dark Pro color scheme, frameless window, draggable sidebar and side-terminal widths

Getting Started

Prerequisites

• Node.js 18+
• Rust 1.70+
• pnpm (recommended)

Linux System Dependencies

Ubuntu / Debian

sudo apt install -y build-essential libwebkit2gtk-4.1-dev \
  libappindicator3-dev librsvg2-dev patchelf libgtk-3-dev

Fedora

sudo dnf install -y gcc gcc-c++ webkit2gtk4.1-devel \
  libappindicator-gtk3-devel librsvg2-devel

Arch Linux

sudo pacman -S base-devel webkit2gtk-4.1 libappindicator-gtk3 librsvg

Install & Run

# Install frontend dependencies
pnpm install

# Development mode
pnpm tauri dev

# Build release
pnpm tauri build

Tech Stack

Preset Agents

opencode, claude-code, gemini, codex, qoder, codebuddy

Custom Agents can be added and built-in Agent commands can be overridden in the Settings panel.

Preset IDEs

Override launch commands for each IDE or add custom IDEs in the settings panel.

Keyboard Shortcuts

License

Apache 2.0