Repository navigation
Releases
Konsoll 3.7.1-beta.3
What's new (beta)
The same changes as 3.7.1-beta.1, published again so that it reaches
everyone in the beta channel. The stable release is still 3.7.0. There was
no public beta.2.
Changed
- Images (kitty graphics, sixel, iTerm2 inline images) are kept in one place
only. The renderer takes the pixels from there when it draws them, instead
of holding its own reference to every image on screen. - An agent whose pane closes while
read_panewaits for your answer now
gets its "Your pane was closed" reply from the closing pane itself.
Please report images that flicker, go missing or show stale frames
(animations included), and anything odd with agents asking to read a pane.
Install
Konsoll is not notarized by Apple. After moving konsoll.app to
/Applications, clear the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/konsoll.appOr open it, then allow it in System Settings → Privacy & Security →
Open Anyway. Requires macOS 14.4+ on Apple Silicon.
Pre-release built from
6a6be63for testing; the latest
release remains the stable version.
Full Changelog: v3.7.1-beta.1...v3.7.1-beta.3
Konsoll 3.7.1-beta.1
What's new (beta)
A beta of internal changes on the way to 3.7.1. The stable release is still
3.7.0, and nothing should look different.
Changed
- Images (kitty graphics, sixel, iTerm2 inline images) are kept in one place
only. The renderer takes the pixels from there when it draws them, instead
of holding its own reference to every image on screen. - An agent whose pane closes while
read_panewaits for your answer now
gets its "Your pane was closed" reply from the closing pane itself.
Please report images that flicker, go missing or show stale frames
(animations included), and anything odd with agents asking to read a pane.
Install
Konsoll is not notarized by Apple. After moving konsoll.app to
/Applications, clear the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/konsoll.appOr open it, then allow it in System Settings → Privacy & Security →
Open Anyway. Requires macOS 14.4+ on Apple Silicon.
Pre-release built from
3402d82for testing; the latest
release remains the stable version.
What's Changed
New Contributors
Full Changelog: v3.7.0...v3.7.1-beta.1
Konsoll 3.7.0
What's new
3.7.0 keeps Konsoll up to date by itself.
Updates
- Automatic updates. Once a day Konsoll looks for a newer release,
downloads it in the background and installs it when you quit. Updates are
signed, and they open without clearing the quarantine flag. - Konsoll ▸ Check for Updates… checks right away, shows what changed and
offers to install and relaunch. - Settings ▸ Updates turns the automatic checks and downloads off and
picks the channel: Stable only (the default) or Stable and beta,
which also offers pre-releases for testing.
This is the last version to install by hand: from here on, Konsoll updates
itself.
Install
Konsoll is not notarized by Apple. After moving konsoll.app to
/Applications, clear the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/konsoll.appOr open it, then allow it in System Settings → Privacy & Security →
Open Anyway. Requires macOS 14.4+ on Apple Silicon.
Full Changelog: v3.6.0...v3.7.0
Konsoll 3.6.0
What's new
3.6.0 brings AI coding agents into Konsoll: Claude Code, Codex, Qwen Code
and opencode show what they are doing in the tab, ask for you through
macOS notifications, and can use your terminal as context. Everything below
is new since 3.5.0 (it was tried in five betas).
AI agents in your tabs
- The tab shows what the agent is doing. The agents report their state
from their own hooks: working, waiting for you (a permission or a
question, shown in the tab's tooltip), finished or failed. A tab with
several panes shows the most urgent one. - Notifications when an agent needs you. When an agent waits for you,
finishes or fails in a pane you are not looking at, macOS shows a
notification; clicking it brings you to that pane. The "finished"
notification names the task. Turn them off in Settings ▸ AI Agents. - Answer permission prompts without leaving what you are doing. When an
agent asks to run a tool, the notification shows what it wants — the
command, the file — with Allow and Deny. The answer goes to the
agent's pane as if typed there, and Konsoll stays in the background. - Window ▸ AI Agents (⇧⌘A) lists the panes running an agent across every
window, the ones waiting for you first, with the same Allow / Deny
buttons, the task each agent is working on and how long it has waited.
The Dock icon counts the agents waiting for you.
Your terminal as the agent's context
- Send to Agent: right-click a pane to paste the selection, or the last
command with its exit status and output, into an agent's pane as its next
prompt. With more than one agent open, the menu lists each one by name,
tab and task, the ones in the same tab first. - MCP server:
konsoll --mcpgives an agent tools limited to the pane
it runs in:open_pane(a split beside it running a command, without
taking the focus),run_in_backgroundandbackground_job_status(only
the jobs that agent started),recent_commands(the commands run in its
pane, with their output),list_panesandread_pane, which reads
another pane — a dev server's log, a test run — only after you allow it.
Settings ▸ AI Agents has the command or configuration to register it with
each agent.
Agents in parallel
- Shell ▸ New Agent in Worktree… creates a git worktree of the current
repository on a branch and starts the agent of your choice there in a new
tab, apart from your checkout.
Agents over SSH
ssh hosttyped in a zsh or bash tab brings Konsoll's shell integration
to the host for that session, with nothing installed there. Claude Code,
Codex and Qwen Code started on the host show their state in the tab, ask
for permission through Konsoll's notifications, and are listed by Send to
Agent; the host's commands become command blocks, so Send Last Command to
Agent works there too.- The setup lives in a private temporary folder removed when the shell
exits, and the agents get Konsoll's hooks for that run only. - Logins with a remote command,
-N,-W, aRemoteCommandin
ssh_configor a host excluded in Settings ▸ AI Agents run ssh as usual,
and so doescommand ssh. Turn it off in Settings ▸ AI Agents.
Connecting the agents
- Settings ▸ AI Agents ▸ Connect adds Konsoll's hooks to each agent's
settings file, keeping everything else (the previous file is saved as
.konsoll-backup; a file with comments is left untouched), or installs
the opencode plugin. Remove takes them out again, and Update
appears when installed hooks are out of date. - A pane running an agent that is not connected offers to connect it.
- Codex runs new hooks only after you trust them once with
/hooks. - Claude Code can also use the Konsoll plugin from this repository's
marketplace instead.
Fixes
- A crashed program no longer leaves mouse, focus or keyboard reporting on
(every wheel turn used to reach the shell as text such as65;67;25M). - An oh-my-zsh theme that declares its prompt variables with
localno
longer loses them (the prompt showed only the directory). - A command whose line wrapped right after a space no longer loses that
space when sent to an agent or read withrecent_commands.
Install
Konsoll is not notarized by Apple. After moving konsoll.app to
/Applications, clear the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/konsoll.app
Or open it, then allow it in System Settings → Privacy & Security →
Open Anyway. Requires macOS 14.4+ on Apple Silicon.
Full Changelog: v3.5.0...v3.6.0
Konsoll 3.6.0-beta.5
What's new (beta)
The fifth beta of AI coding agents in Konsoll. The stable release is still
3.5.0.
Agents over SSH
ssh hosttyped in a zsh or bash tab brings Konsoll's shell integration
to the host for that session, with nothing installed there. Claude Code,
Codex and Qwen Code started on the host show their state in the tab, ask
for permission through Konsoll's notifications (Allow / Deny answer in the
pane), and are listed by Send to Agent.- The host's commands become command blocks, so Send Last Command to Agent
works inside ssh too. - The setup lives in a private temporary folder removed when the shell
exits, and the agents get Konsoll's hooks for that run only. Codex runs
them once you trust them with/hooks; opencode is only listed. - The login still shows the host's message of the day and last login.
- Logins with a remote command,
-N,-W, aRemoteCommandin
ssh_configor a host excluded in Settings ▸ AI Agents run ssh as usual,
and so doescommand ssh. Turn it off in Settings ▸ AI Agents.
Fixed
- An oh-my-zsh theme that declares its prompt variables with
locallost
them in Konsoll (the prompt showed only the directory): the shell's
startup files now run at the top level. - Send Last Command to Agent was cut short in the pane menu.
- Codex no longer warns about the length of Konsoll's SessionEnd hook
(reconnect Codex in Settings ▸ AI Agents to update an installed one).
Everything from the earlier betas is still here: Send to Agent with a
choice of agent, Allow / Deny on permission prompts from the notification or
Window ▸ AI Agents, the agent's task and waiting time, the Dock badge, the
context tools of konsoll --mcp, and New Agent in Worktree.
Install
Konsoll is not notarized by Apple. After moving konsoll.app to
/Applications, clear the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/konsoll.appOr open it, then allow it in System Settings → Privacy & Security →
Open Anyway. Requires macOS 14.4+ on Apple Silicon.
Pre-release built from
c37f120for testing; the latest
release remains the stable version.
Full Changelog: v3.6.0-beta.4...v3.6.0-beta.5
Konsoll 3.6.0-beta.4
What's new (beta)
The fourth beta of AI coding agents in Konsoll. The stable release is still
3.5.0.
Send to Agent picks the agent
- With more than one agent open, Send Selection To and Send Last
Command To are submenus listing each agent by name, tab and task — the
ones in the same tab first — instead of always sending to the first one.
With a single agent the menu is unchanged.
Fixed
- A command whose line wrapped right after a space (a long prompt) lost
that space when sent to an agent or read withrecent_commands.
Everything from the earlier betas is still here: Allow / Deny on permission
prompts from the notification or Window ▸ AI Agents, the agent's task and
waiting time, the Dock badge, the context tools of konsoll --mcp, and New
Agent in Worktree.
Install
Konsoll is not notarized by Apple. After moving konsoll.app to
/Applications, clear the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/konsoll.appOr open it, then allow it in System Settings → Privacy & Security →
Open Anyway. Requires macOS 14.4+ on Apple Silicon.
Pre-release built from
e80ffcbfor testing; the latest
release remains the stable version.
Full Changelog: v3.6.0-beta.3...v3.6.0-beta.4
Konsoll 3.6.0-beta.3
What's new (beta)
The third beta of AI coding agents in Konsoll. The stable release is still
3.5.0. Agents connected with an earlier beta show Update in Settings ▸
AI Agents (or in the pane): update, then restart the agent.
Answer permission prompts without leaving what you are doing
- When an agent asks to run a tool, the notification shows what it wants —
the command, the file — with Allow and Deny (hover it, or click
its arrow). The answer goes to the agent's pane as if typed there, and
Konsoll stays in the background. - Window ▸ AI Agents has the same buttons, plus the task each agent is
working on and how long it has waited. The Dock icon counts the agents
waiting for you, and the "finished" notification names the task.
Your terminal as the agent's context
- Send to Agent: right-click a pane to paste the selection, or the last
command with its exit status and output, into the agent's pane as its
next prompt. - MCP tools (after registering
konsoll --mcp):recent_commands(the
commands you ran in the agent's pane before starting it, with their
output),list_panesandread_pane, which reads another pane — a dev
server's log, a test run — only after you allow it in the agent's pane or
on the notification.
Agents in parallel
- Shell ▸ New Agent in Worktree… creates a git worktree of the current
repository on a branch and starts the agent of your choice there in a new
tab, apart from your checkout.
Smaller things
- A pane running an agent that is not connected offers to connect it.
- Settings ▸ AI Agents shows the agents' files from
~. - Fixes: a crashed program no longer leaves the mouse reporting on (since
beta.2); the "finished" notification no longer shows an agent's internal
messages as the task.
Install
Konsoll is not notarized by Apple. After moving konsoll.app to
/Applications, clear the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/konsoll.appOr open it, then allow it in System Settings → Privacy & Security →
Open Anyway. Requires macOS 14.4+ on Apple Silicon.
Pre-release built from
bc6ac77for testing; the latest
release remains the stable version.
Full Changelog: v3.6.0-beta.2...v3.6.0-beta.3
Konsoll 3.6.0-beta.2
What's new (beta)
The second beta of AI coding agents in Konsoll: see
v3.6.0-beta.1
for what they bring (agent state in the tab, notifications, Window ▸ AI
Agents, Settings ▸ AI Agents and the MCP server). The stable release is
still 3.5.0.
Fixes since beta.1
- A crashed program no longer leaves the mouse reporting on. When a
program died with mouse, focus or keyboard reporting on (an agent running
out of memory,kill -9), every wheel turn reached the shell as text such
as65;67;25M. The next prompt now turns these modes off.
Install
Konsoll is not notarized by Apple. After moving konsoll.app to
/Applications, clear the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/konsoll.appOr open it, then allow it in System Settings → Privacy & Security →
Open Anyway. Requires macOS 14.4+ on Apple Silicon.
Pre-release built from
74ef6a2for testing; the latest
release remains the stable version.
Full Changelog: v3.6.0-beta.1...v3.6.0-beta.2
Konsoll 3.6.0-beta.1
What's new (beta)
This beta brings AI coding agents into Konsoll. Try it for a while and
report what feels off; the stable release is still 3.5.0.
AI agents in your tabs
- The tab shows what the agent is doing. Claude Code, Codex, Qwen Code
and opencode report their state from their own hooks: working, waiting for
you (a permission or a question, shown in the tab's tooltip), finished or
failed. A tab with several panes shows the most urgent one. - Notifications when an agent needs you. When an agent waits for you,
finishes or fails in a pane you are not looking at, macOS shows a
notification; clicking it brings you to that pane. The first one asks for
permission. Turn them off in Settings ▸ AI Agents. - Window ▸ AI Agents (⇧⌘A) lists the panes running an agent across every
window, the ones waiting for you first.
Connecting the agents
- Settings ▸ AI Agents ▸ Connect adds Konsoll's hooks to each agent's
settings file, keeping everything else (the previous file is saved as
.konsoll-backup; a file with comments is left untouched), or installs the
opencode plugin. Remove takes them out again. - Codex runs new hooks only after you trust them once with
/hooks. - Claude Code can also use the Konsoll plugin from this repository's
marketplace instead.
MCP server
konsoll --mcpgives an agent three tools, limited to the pane it runs
in:open_pane(a split beside it running a command, without taking the
focus),run_in_background(a Background Command) and
background_job_status(state and output of the jobs that agent started,
and only those). Nothing reads another pane. Settings ▸ AI Agents has the
command or configuration to register it with each agent.
Install
Konsoll is not notarized by Apple. After moving konsoll.app to
/Applications, clear the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/konsoll.appOr open it, then allow it in System Settings → Privacy & Security →
Open Anyway. Requires macOS 14.4+ on Apple Silicon.
Pre-release built from
3c27c17for testing; the latest
release remains the stable version.
Full Changelog: v3.5.0...v3.6.0-beta.1
Konsoll 3.5.0
What's new
Memory: unlimited scrollback that stays small
- Compacted history. Scrollback lines are stored as their content only
(style runs and compact code points, trailing blanks dropped), instead of a
full-width row of cells: a short line now costs a few bytes instead of
2.8 KB.yesfor 15 s grew Konsoll to 24 GB before; it now peaks at about
0.5 GB, and 1M lines ofyestake 16 MB instead of 3.2 GB. - Memory goes back to the system. History lives in blocks mapped straight
from the system, so clearing the buffer (⌃K), trimming the limit or closing
a tab returns the memory at once (macOS kept freed memory before). - Settings ▸ Terminal: scrollback limit. Unlimited stays the default; a
line limit can be set instead and applies to every open session right away.
Speed
- Twice as fast under heavy output. Output read from the shell is batched
before it reaches the screen, and the per-chunk work (frame timer,
scrollbar, settings reads) is gone: 5M lines ofyestake 6.7 s instead of
14 s, close to the macOS terminal driver's own limit (6.1 s). - Quitting vim, less or top no longer stalls with a long history: leaving
the alternate screen re-wraps only the screen (2.2 s and a 4.3 GB peak with
300k lines before, under a millisecond now), and so does a height-only
resize. A width change with a big history is applied once the window stops
being resized instead of on every step of the drag. - Scrolling moves rows instead of copying them.
Tabs
- Static icons instead of a spinner. A busy tab shows what it is doing —
network transfers (curl, wget, rsync, scp…), archives (tar, zip…), package
managers (brew, pip, uv…), searches (find, grep, rg…),sleep,watch—
and a static "running" icon for anything else. Nothing animates, so a long
job costs no redraws (the spinner cost up to 8% of a core). - Glass tabs. The tabs are drawn as glass panes over the strip, which
falls back to the same look where native Liquid Glass is not available.
Fixes
- Closing a tab now ends every job in it, including ones that ignore SIGHUP;
they used to keep running (and the tab could fail to close). - Large pastes are no longer cut at about 1 KB (a lost bracketed-paste end
left programs stuck in paste mode).
Documentation
- The README has a performance comparison with iTerm2 and refreshed
screenshots and GIFs, taken over the desktop wallpaper so the window's blur
and transparency show.
Install
Konsoll is not notarized by Apple. After moving konsoll.app to
/Applications, clear the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/konsoll.appOr open it, then allow it in System Settings → Privacy & Security →
Open Anyway. Requires macOS 14.4+ on Apple Silicon.
Full Changelog: v3.4.3...v3.5.0