Desktop cockpit for coding agents

GenNal

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.

6 Install formats
3 Operating systems
0 Extra API keys

Download

Install GenNal v1.5.12 on your device

Available for Windows, macOS, and Linux. Pick the installer for your operating system and CPU architecture.

Windows macOS Linux
Windows · x64

Setup installer

Windows 10 and 11, 64-bit (Intel / AMD).

.exe
macOS · x64

Intel Mac

Intel-based Macs — macOS 11 or later.

.dmg
Linux · x64

AppImage

Portable — runs on Ubuntu, Fedora, Arch, and most desktops.

.AppImage
Linux · x64

Debian package

Ubuntu, Debian, Linux Mint, Pop!_OS, and derivatives.

.deb
iPhone · Android New

GenNal Remote

Reach your computer from your phone, on any network. Nothing to install on the phone.

How it works

New · GenNal Remote

Your computer, in your pocket

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.

  • Chat with your sessions
  • Drive live terminals
  • Watch your computer's screen
  • Stream your phone camera
  1. Open GenNal on your computer Account menu → Connect a phone → Anywhere → Sign in with Google.
  2. Open GenNal Remote on your phone Scan the code GenNal shows, or type the address below.
  3. Sign in and pick your computer Use the same Google account. Every project on it is there.
Open GenNal Remote 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.

All devices — pick your download

  • Windows PC x64 · Setup installer
    Windows 10 / 11 · Intel & AMD 64-bit GenNal-Setup-1.5.12.exe Download
  • Mac · Intel x64 · Disk image
    Intel Mac · macOS 11+ GenNal-1.5.12-x64.dmg Download
  • Linux · AppImage x64 · Portable
    Ubuntu, Fedora, Arch, any 64-bit desktop GenNal-1.5.12.AppImage Download
  • Linux · Debian x64 · .deb package
    Ubuntu, Debian, Mint, Pop!_OS GenNal-1.5.12.deb Download
Windows10 / 11x64 (Intel, AMD).exe installer
macOS11+arm64 (M-series) · x64 (Intel).dmg disk image
Linux64-bit desktopx64.AppImage · .deb

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

GenNal 1.5: a new look, built around the chat

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.

Images inline in your message

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.

Save or copy any image

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.

Every session in one place

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.

Continue any session

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.

Keep asking while it works

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.

A diff for every reply

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.

Watch every step live

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.

Appearance: light, dark and seven themes

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.

Pick up where you left off

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.

Your phone, now with your screen

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.

Usage: cost, tokens and limits

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

Agents on one side, code on the other

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.

Agents Window

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.

Editor Window

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

Threads, terminals, and code in one flow

Organize work by project thread. Launch agents in the grid. Keep code, output, and problems on the right panel.

  1. 01

    Open a thread

    Each project thread keeps its own workspace, files, and running model sessions.

  2. 02

    Launch agents

    Start Codex, Claude, Gemini, a shell, or a custom CLI — or use ⌘ K from the command palette.

  3. 03

    Refine & ship

    Use ai-prompt-generator for better agent prompts, generate commit messages, Commit & Push, and watch usage quotas in the sidebar.

  4. 04

    Switch to the editor

    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

Everything in the app, on the page

No mock dashboard — every feature below is in the desktop app you download.

ai-prompt-generator

Turn a rough idea into a structured, copy-paste prompt for Cursor, Claude Code, Codex, or Gemini — from the composer or ⌘ K.

Commit message & push

Generate commit messages from your diff with the model you choose, then Commit or Commit & Push from the Environment panel.

Live usage & quotas

Codex and Claude rate limits in the sidebar. Full provider overview, plan limits, and session stats in Settings → Usage.

Thread workspace

Organize projects and threads in the sidebar. Each thread keeps its own sessions and files.

Display & themes

Scale the whole UI, pick a default model grid with visual previews, and browse 25+ categorized themes in Settings → Display.

Live model panes

Real PTY terminals with start, stop, restart, split, and close — grid, tabs, stack, or float.

Command palette

⌘ K / Ctrl K to launch models, switch layouts, open preview, and more.

Editor Window

A dedicated code surface: Open Editors, project tree, tabs with unsaved markers, git gutters, and a welcome page.

Agent chat dock

Chat with a model right beside the file you're editing — history, usage, model picker, and a resizable dock.

Extensions marketplace

Install or remove Editor, Agents, Database, Board, Simulators, and Computer Use. First-party and offline — nothing is downloaded.

Search & replace

Project-wide search with match case, whole word, regex, and include/exclude globs — then replace across every file.

Terminal & Run panel

⌃ ` opens live shells under the editor, plus a Run tab that streams the open file's output.

Code & preview panel

Code editor, output, terminal, problems, and in-app localhost browser preview.

Database client

Connect SQLite, PostgreSQL, or MySQL. Browse schemas, page through rows, run SQL — writes ask before they touch data.

Board, tasks & automations

Kanban board, GitHub tasks, scheduled agent runs, and session history — all in one cockpit.

Tour

The v1.5.12 interface

The agent grid, usage quotas, themes, and the new Editor Window — built from the actual app layout.

Multi-agent grid

Flush tiles with thin headers — zsh, Claude, Codex, Gemini, each still its own session.

Usage sidebar

Provider quotas at a glance. Hover for detail, click for the full overview.

Theme picker

13 built-in themes led by the GenNal brand look — window chrome syncs automatically.

Editor Window

Tabs, terminal panel, and an agent docked on the right — with a pill back to the Agents Window.

Models

Works with the CLI tools already on your machine

Codexcodex Claudeclaude Geminigemini Cursorcursor Customany CLI

GenNal launches the CLI process locally. Your prompts and project files go to the provider CLI you choose, not to a GenNal server.

Requirements

System requirements

WindowsWindows 10 or 11, x64 (Intel / AMD) — .exe installer
macOSmacOS 11+, Apple Silicon (arm64) or Intel (x64) — .dmg
Linux64-bit desktop — AppImage or .deb (x64)
Hardware8 GB RAM min (16 GB recommended), 500 MB disk + projects

FAQ

Questions, answered

Do I need API keys to use GenNal?

No extra GenNal API keys are required. Sign in to the model CLIs directly, then GenNal runs those tools in local terminal panes.

What's the difference between the Agents Window and the Editor Window?

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.

How do extensions work?

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.

Can I search and replace across the whole project?

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.

How does the prompt generator work?

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.

Can GenNal write commit messages and push for me?

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.

How does usage tracking work?

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.

Does GenNal upload my code to its own servers?

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.

Can I add a model that is not listed?

Yes. Register a name, command, arguments, and accent color for any command-line tool in models.json.

Which platforms and devices are supported?

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.