Setup installer
Windows 10 and 11, 64-bit (Intel / AMD).
.exe
GenNal
v1.5.12
Desktop cockpit for coding agents
Gen = Generation · Nal = Terminal
Vibe coding, limitless possibilities. Two windows in one app: the Agents Window runs Codex, Claude, Gemini, and custom CLIs side by side, and the Editor Window gives code the whole screen — with an agent docked beside it, a terminal panel underneath, and extensions you install only if you want them.
Download
Available for Windows, macOS, and Linux. Pick the installer for your operating system and CPU architecture.
Windows 10 and 11, 64-bit (Intel / AMD).
.exeM1, M2, M3, M4 Macs — macOS 11 or later.
.dmgIntel-based Macs — macOS 11 or later.
.dmgPortable — runs on Ubuntu, Fedora, Arch, and most desktops.
.AppImageUbuntu, Debian, Linux Mint, Pop!_OS, and derivatives.
.debReach your computer from your phone, on any network. Nothing to install on the phone.
How it worksNew · GenNal Remote
Sign in with the same Google account on your computer and your phone. Your phone then sees every project and session on that computer — from home, the office, or mobile data.
gennal-relay.onrender.com
Only your Google account can reach your computer, and it can run commands there. Pause or sign out in GenNal at any time. No Google account? Use Same Wi-Fi and scan a QR code instead.
GenNal-Setup-1.5.12.exe
Download
GenNal-1.5.12-arm64.dmg
Download
GenNal-1.5.12-x64.dmg
Download
GenNal-1.5.12.AppImage
Download
GenNal-1.5.12.deb
Download
Installers are unsigned — Windows SmartScreen and macOS Gatekeeper may warn on first run. Choose Run anyway or right-click → Open. Downloads are served from this site. Release notes and source on GitHub.
What's new in v1.5.12
v1.5.12 makes long session lists easier to scan: each project opens with its newest three chats and a Show more button, older chats come back as one-line rows, and every title fits on one line, with the full title, project, computer and model in a card when you hover. Hold ⌘ (Ctrl on Windows and Linux) to see ⌘1–⌘9 on the first nine sessions, and press one to open it. Settled sits at the bottom of the sidebar; opening a settled session shows it there and says “Settled 4d ago · Un-settle” under the last reply. The Show usage button under the sidebar is gone: turn the usage card on in Settings › Usage & accounts. v1.2.6, v1.2.7 and v1.2.8 still cannot update themselves — download GenNal once from this page. Mac users on v1.0.34 or v1.0.35 also need this .dmg once.
Paste an image while you type and it drops in as a chip right at the cursor. Keep writing around it — the sent message shows it in the same place.
Right-click an image in a chat — a sent-message tile, an attachment or the preview — to save it under its file name or copy it to paste anywhere.
The sidebar and the Sessions view list chats, terminals open in GenNal, and agent sessions from terminals and other apps — split into Chat, Terminal and Apps, with clean titles and a badge on each.
Pick a session from a terminal or another app and press Continue: its conversation opens as a GenNal chat on the same Claude, Codex or Gemini session, so the model remembers everything.
Messages you send during a reply wait in a Queued bubble and go out when it finishes — or send one now. The status line shows what the model is thinking and which tool it is running.
Each reply that edits code ends with a changed-files card — +/− per file in a folder tree. Open diff shows the turn beside the chat, unified or split, with a turn picker to step back through earlier replies.
A Working-for timer, then each step as it happens — Thought, Running python3, Reading store.ts — with the finished work folding into “Worked for 5m 9s”. Tick marks on the left jump between messages.
Choose System, Light or Dark, then a theme — GenNal, T3 Code, T3 Chat, Grove, Ocean, Ember or Iris — each with a light and a dark look. Create or import your own, and tune contrast and glass. The default is black and white.
Quit and reopen: your session tabs come back with the one you were in, unsent drafts included, and the model keeps its context. A reply cut off by quitting offers Continue, and ↑ in the composer brings back what you sent.
The phone remote is redesigned in black and white: the same sessions as your computer, live progress like “Running python3…”, and a Computer screen view to watch your Mac live. Allow GenNal under Screen Recording on the Mac first.
A Usage page reads your local Claude Code and Codex logs: cost and tokens over 24 hours to 90 days, a breakdown by model and day, and each plan limit with its reset time. Nothing leaves your computer.
Two windows
One app, two surfaces, one switch between them. Run your agents where terminals belong, write code where an editor belongs — the same workspace, the same git state, the same sessions still running underneath.
The cockpit. Threads and projects down the left, live model panes in a grid, tabs, stack, or float layout, usage quotas under the sidebar, and the environment panel on the right. This is where you launch Codex, Claude, Gemini, and any CLI you registered, and watch them work.
The code surface. Explorer, search, and git-changes rails on the left, tabs and the editor in the middle, terminal and run output below, agent chat on the right. Run or stop the open file from the header, and jump back with the Agents Window pill any time.
Switching windows never restarts anything. Your agent sessions, terminals, and running dev servers stay alive in the background — the app just changes what it shows you.
Experience
Organize work by project thread. Launch agents in the grid. Keep code, output, and problems on the right panel.
Each project thread keeps its own workspace, files, and running model sessions.
Start Codex, Claude, Gemini, a shell, or a custom CLI — or use ⌘ K from the command palette.
Use ai-prompt-generator for better agent prompts, generate commit messages, Commit & Push, and watch usage quotas in the sidebar.
Open the Editor Window to write the code yourself — tabs, search and replace, a terminal panel, and an agent docked beside you. Your sessions keep running behind it.
Features
No mock dashboard — every feature below is in the desktop app you download.
Turn a rough idea into a structured, copy-paste prompt for Cursor, Claude Code, Codex, or Gemini — from the composer or ⌘ K.
Generate commit messages from your diff with the model you choose, then Commit or Commit & Push from the Environment panel.
Codex and Claude rate limits in the sidebar. Full provider overview, plan limits, and session stats in Settings → Usage.
Organize projects and threads in the sidebar. Each thread keeps its own sessions and files.
Scale the whole UI, pick a default model grid with visual previews, and browse 25+ categorized themes in Settings → Display.
Real PTY terminals with start, stop, restart, split, and close — grid, tabs, stack, or float.
⌘ K / Ctrl K to launch models, switch layouts, open preview, and more.
A dedicated code surface: Open Editors, project tree, tabs with unsaved markers, git gutters, and a welcome page.
Chat with a model right beside the file you're editing — history, usage, model picker, and a resizable dock.
Install or remove Editor, Agents, Database, Board, Simulators, and Computer Use. First-party and offline — nothing is downloaded.
Project-wide search with match case, whole word, regex, and include/exclude globs — then replace across every file.
⌃ ` opens live shells under the editor, plus a Run tab that streams the open file's output.
Code editor, output, terminal, problems, and in-app localhost browser preview.
Connect SQLite, PostgreSQL, or MySQL. Browse schemas, page through rows, run SQL — writes ask before they touch data.
Kanban board, GitHub tasks, scheduled agent runs, and session history — all in one cockpit.
Tour
The agent grid, usage quotas, themes, and the new Editor Window — built from the actual app layout.
Flush tiles with thin headers — zsh, Claude, Codex, Gemini, each still its own session.
Provider quotas at a glance. Hover for detail, click for the full overview.
13 built-in themes led by the GenNal brand look — window chrome syncs automatically.
Tabs, terminal panel, and an agent docked on the right — with a pill back to the Agents Window.
Models
GenNal launches the CLI process locally. Your prompts and project files go to the provider CLI you choose, not to a GenNal server.
Requirements
FAQ
No extra GenNal API keys are required. Sign in to the model CLIs directly, then GenNal runs those tools in local terminal panes.
They are two views of the same app, not two apps. The Agents Window is the cockpit: threads, projects, live model panes in a grid, and usage quotas. The Editor Window gives code the whole screen: explorer, tabs, project-wide search, a terminal and run panel underneath, and an agent chat docked on the right. Switch with the pill in the header — nothing restarts, and your terminals and dev servers keep running.
Every extension is first-party and already inside the app — installing one just decides whether it appears. Open Settings → Extensions (or the Extensions rail in the editor), search, and install or remove Editor, Agents, AI Prompt Generator, Database Client, Workspace Board, Mobile Simulators, or Computer Use. Nothing is fetched from the internet, and the nav rail only shows what you kept.
Yes. The editor's Search rail does project-wide search with match case, whole word, and regex, plus include and exclude glob filters, and can replace across every match. It skips node_modules, build output, and binary files by default.
Type a rough idea in the composer and click the sparkle button (or run ai-prompt-generator from ⌘ K). GenNal sends your idea to the selected model CLI and returns a structured prompt with context, task, constraints, and verification steps — ready to copy into any coding agent.
Yes. In the Environment panel, open Changes, click Generate commit message to draft from your diff (pick which model writes it), then Commit or Commit & Push. You can scope commits to a single folder when needed.
GenNal reads quota data from local CLI files (Codex, Claude) and shows remaining limits in the sidebar. Gemini and Cursor show activity and sign-in status. Open Settings → Usage for the full breakdown.
No. GenNal is a desktop shell around local CLIs and local workspace files. The provider CLI you run controls where prompts and code are sent.
Yes. Register a name, command, arguments, and accent color for any command-line tool in models.json.
GenNal runs on Windows 10/11 (x64), macOS 11+ on Apple Silicon and Intel Macs, and 64-bit Linux desktops. Linux installs are available as AppImage (portable), .deb (Ubuntu/Debian), or .snap. Phones connect with GenNal Remote — from any network with your Google account, or on the same Wi-Fi with a QR code — and the desktop app itself requires Windows, macOS, or Linux.