Skip to content

knkenko/knkode

Repository files navigation

knkode icon knkode — Terminal Workspace Manager

A terminal workspace manager for macOS and Windows that saves your multi-pane layouts so you stop rebuilding them every morning. Like tmux sessions, but with a native GUI, split panes, and themed workspaces.

Matrix terminal theme — green phosphor CRT effect Cyberpunk terminal theme — neon glow effect Vaporwave terminal theme — retro gradient effect Amber terminal theme — warm monochrome CRT effect
Solana terminal theme — purple gradient effect Ocean terminal theme — deep blue effect Sunset terminal theme — warm orange effect Arctic terminal theme — cool ice blue effect

Each theme has its own visual effects — scanlines, phosphor glow, noise textures, gradient overlays — applied to terminal backgrounds and pane chrome. These aren't color swaps.

Download

Latest release (v2.3.0)

Platform File
macOS (Apple Silicon + Intel) knkode_2.3.0_universal.dmg
Windows (installer) knkode_2.3.0_x64-setup.exe
Windows (MSI) knkode_2.3.0_x64_en-US.msi

Why use knkode

Every project needs a different terminal setup — build watcher, dev server, logs, a shell for git. You arrange them, close the window, and rebuild the whole thing next time. knkode saves each arrangement as a named workspace you can switch between instantly.

Features

Workspaces as tabs. Each workspace is a color-coded tab with its own split-pane layout. Create, duplicate, close, drag to reorder, or reopen from the closed-workspaces menu. Switching is instant — background shells stay alive.

Split panes and subgroups. Six layout presets plus split any pane on the fly. Drag pane headers to rearrange — drop on center to swap, drop on an edge to insert. Move panes across workspaces via right-click. Within a workspace, group panes into subgroups — independent split layouts switchable from the sidebar (like tmux windows within a session). Bracket connectors in the sidebar show which panes belong to which group.

16 themes. 8 identity themes with unique visual effects (Matrix, Cyberpunk, Vaporwave, Amber, Solana, Ocean, Sunset, Arctic) and 8 classics (Dracula, Tokyo Night, Nord, Catppuccin, Gruvbox, Monokai, Everforest, Default Dark). Each has custom pane chrome — parallelogram badges, CRT scanlines, gradient borders, retro grids — and themed animated separators between subgroup brackets. Applied per-workspace, with per-pane color overrides.

Sidebar. Tree-style mission control — workspaces with CWD path, git branch badge, and PR status at the workspace level. Pane entries show terminal titles and activity indicators that pulse on output. Subgroup brackets with themed animated separators (scan, wave, ember, shimmer).

Terminal. Rust-native terminal emulation via wezterm-term, rendered on a custom HTML canvas. Clickable URLs (Cmd+click), inline images (iTerm2/Kitty/Sixel protocols), CWD tracking in pane headers, file drag-and-drop to paste paths. Shift+Enter sends LF instead of CR for tools like Claude Code.

Quick commands. Reusable shell snippets per workspace. Run them from the >_ icon on any pane header.

Persistent. Config stored as JSON in ~/.knkode/. Atomic writes (temp + rename) so crashes don't corrupt state.

Development

Requires Rust, Node.js >= 18, and bun.

git clone https://github.com/knkenko/knkode.git
cd knkode
bun install
bun tauri dev

Opens the app with hot reload. macOS uses a frameless window with native traffic lights; Windows uses the standard title bar.

bun run test         # vitest
bun run check        # biome check
bun run build        # compile frontend
bun tauri build      # full app build (.dmg / .exe)

Stack: Tauri 2, Rust (tattoy-wezterm-term + portable-pty), React 19, TypeScript, Zustand 5, Tailwind CSS 4, Vite 6, Biome.

License

MIT

About

Terminal workspace manager for macOS and Windows — save multi-pane layouts, split terminals, themed workspaces. Built with Tauri, Rust, and React.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors