v0.4.198 — Folder chat messaging

Folder chat now delivers plain-language requests to agents. Ask it to message a named agent, a subfolder, or everyone in the current folder and its subfolders. Existing receipts show delivery and replies, and retrying a failed submission does not duplicate a message.

Ordinary questions still get answers. Requests with unclear recipients ask for clarification, and the server checks recipient scope before sending. The helper now reads: “Ask about this folder, or tell me who to message and what to say. Use @ to choose a recipient.”

Folder AI chat is available in Code and Full. The existing explicit inbox messaging remains available in Lite. There are no database schema changes.

Downloads include signed, notarized Apple Silicon apps for Lite, Code, and Full (macOS 13 or later), plus the Python wheel and source package. SHA256SUMS and release.json identify the assets.

DuckTerm 0.4.197

What's new

• Security: a repository can no longer send your DuckTerm token elsewhere. Before, a repo's .claude/settings.json could set DUCKTERM_URL or a proxy, and DuckTerm's hook and command line would send your owner token and prompts there. They now accept only a local address (127.0.0.1, localhost or [::1]), ignore proxies and redirects for DuckTerm's own requests, and print a one-line warning when they ignore a setting. Proxies still apply to GitHub, AI providers, connectors and updates.
• DuckTerm Lite gets the continuity tools. Inbox and folder messages, checkpoints, summaries, maintained memory, reviewed handoffs and saved artifacts now work in Lite. Code gains saved artifacts. Every edition gets factual folder and global overviews; folder AI chat stays in Code and Full, and Oracle chat and remote workspaces stay in Full. In Full, Oracle now sits above the sidebar folders.
• Guided agent setup on first launch. New users can install Claude Code or Codex from the provider's official installer, sign in, and pick which executable to use, from a setup wizard. Existing workspaces can open it from Settings.
• Compact works. The context panel's Compact button now submits /compact instead of leaving it typed. It's only available while the agent is idle, so it can't land in a busy turn or an approval prompt.
• Cloning a repository keeps its symbolic links instead of following them, and artifact downloads always save as files rather than opening as pages.

Downloads

Edition	Download (always the latest)	App
Lite	DuckTerm-Lite-macos-arm64.zip	DuckTerm Lite.app
Code	DuckTerm-Code-macos-arm64.zip	DuckTerm Code.app
Full	DuckTerm-Full-macos-arm64.zip	DuckTerm.app

Each also has a versioned copy (DuckTerm-<Edition>-0.4.197-macos-arm64.zip). All are notarized and need macOS 13 or later on Apple silicon. No changes to DuckTerm's main database. If you also use the pipx install: opening an app with no DuckTerm server running moves DuckTerm's hooks to that app, and duckterm install-hooks from the pipx install moves them back.

Other files

• duckterm-0.4.197-py3-none-any.whl: command line and server for pipx install
• SHA256SUMS, release.json (lists each asset with its edition)

DuckTerm 0.4.196

Session ducks now get warmer as their remaining context shrinks: yellow below 55% used, a warm tint at 55%, orange at 80%, and red at 95%. The colours interpolate as usage grows and reset after compaction.

The sidebar, session panel and Oracle share the same colour calculation. Reported capacity takes priority; unknown windows and sleeping sessions stay yellow. Numeric warning badges remain, with context descriptions available to screen readers and on hover.

This release also fixes Timeline columns collapsing after opening PR history.

No database schema changes. The Full, Lite and Code Mac apps include their own runtime and require macOS 13 or later on Apple silicon. Context colours appear in editions that include context information.

Download DuckTerm-Full-macos-arm64.zip for DuckTerm.app, or choose the Code or Lite archive. The wheel is available for pipx installations. Versioned archives, checksums and a release manifest are also attached.

DuckTerm 0.4.194

What's new

• Checkpoints work on long sessions again. Long-running sessions often failed to save a checkpoint ("oversized_record"), and some couldn't checkpoint at all. Catch-ups are now split into parallel, size-bounded parts, so they finish.
• Better resumes. Checkpoint summaries no longer use the low-effort setting. Memory items are reconciled in one checked pass and tidied once a session has more than 150 open items; an item only closes when there's evidence for it.
• Handoffs always fit. A session's goals and rules are always kept in full, along with its newest five narratives. When space runs out, the oldest facts are left out first. They stay readable with duckterm memory items --category facts.
• Less disk use. Checkpoints no longer copy every tool event to its own file, which had reached over 100,000 files on busy machines. Existing files are left in place.
• Faster server start. Starting the server re-read checkpoint evidence once for every expired event, which could take several minutes on a busy machine. It now reads it once.
• No database schema changes.

Downloads

Edition	Download (always the latest)	App
Lite	DuckTerm-Lite-macos-arm64.zip	DuckTerm Lite.app
Code	DuckTerm-Code-macos-arm64.zip	DuckTerm Code.app
Full	DuckTerm-Full-macos-arm64.zip	DuckTerm.app

Each also has a versioned copy (DuckTerm-<Edition>-0.4.194-macos-arm64.zip). All are notarized and need macOS 13 or later on Apple silicon. No changes to DuckTerm's main database. If you also use the pipx install: opening an app with no DuckTerm server running moves DuckTerm's hooks to that app, and duckterm install-hooks from the pipx install moves them back.

Other files

• duckterm-0.4.194-py3-none-any.whl: command line and server for pipx install
• SHA256SUMS, release.json (lists each asset with its edition)

DuckTerm 0.4.193

What's new

• Fixed a server hang. On November 3 the DuckTerm server could freeze for good while its automatic stall-diagnostics timer was being cancelled, until it was killed and restarted. That timer is removed, so diagnostics can no longer stop the server. Existing server-stalls.log files are kept. If the server ever stops responding again, capture a sample with sample <server-pid> 3 -file /tmp/duckterm-server.sample.txt (see docs/server-stalls.md).

Downloads

Edition	Download (always the latest)	App
Lite	DuckTerm-Lite-macos-arm64.zip	DuckTerm Lite.app
Code	DuckTerm-Code-macos-arm64.zip	DuckTerm Code.app
Full	DuckTerm-Full-macos-arm64.zip	DuckTerm.app

Each also has a versioned copy (DuckTerm-<Edition>-0.4.193-macos-arm64.zip). All are notarized and need macOS 13 or later on Apple silicon. No changes to DuckTerm's main database. If you also use the pipx install: opening an app with no DuckTerm server running moves DuckTerm's hooks to that app, and duckterm install-hooks from the pipx install moves them back.

Other files

• duckterm-0.4.193-py3-none-any.whl: command line and server for pipx install
• SHA256SUMS, release.json (lists each asset with its edition)

DuckTerm 0.4.192

What's new

• Message your agents from your iPhone. Ducky can now open an agent's conversation, show recent replies, and send it a message. To turn this on, choose Pair iPhone… on the Mac, tick Allow conversations with agents, and approve with Touch ID. Phones you paired before stay status-only until you pair again this way.
  • A message is delivered once, exactly to the agent you picked, and only while that agent is idle with an empty prompt and you haven't typed in its terminal for two minutes. If delivery is uncertain, Ducky marks it unknown instead of sending it again.
  • Messages that start with !, / or # are refused, because Claude Code and Codex treat those as shell commands, slash commands or memory notes rather than messages to the agent.
  • Revoking a phone or turning Ducky off cancels anything still queued.
  • Access covers every session in this DuckTerm on this Mac.
• Folders and search in Ducky. The phone lists all your sessions in collapsible folders, with search. Test sessions are hidden.
• Sent messages are tracked in a separate private file (ducky-messages/receipts.sqlite, readable only by you). Message text is removed once a message is delivered, cancelled or expired, and records are kept for 24 hours.
• Messaging needs Ducky TestFlight build 5 or later.

Downloads

Edition	Download (always the latest)	App
Lite	DuckTerm-Lite-macos-arm64.zip	DuckTerm Lite.app
Code	DuckTerm-Code-macos-arm64.zip	DuckTerm Code.app
Full	DuckTerm-Full-macos-arm64.zip	DuckTerm.app

Each also has a versioned copy (DuckTerm-<Edition>-0.4.192-macos-arm64.zip). All are notarized and need macOS 13 or later on Apple silicon. No changes to DuckTerm's main database. If you also use the pipx install: opening an app with no DuckTerm server running moves DuckTerm's hooks to that app, and duckterm install-hooks from the pipx install moves them back.

Other files

• duckterm-0.4.192-py3-none-any.whl: command line and server for pipx install
• SHA256SUMS, release.json (lists each asset with its edition)

DuckTerm 0.4.191

What's new

• Pair your iPhone from the app. Choose Pair iPhone… from the DuckTerm menu. The Mac shows a QR code; scan it with Ducky on the phone, check that the device ID matches on both screens, then click Approve and confirm with Touch ID or your Mac password. Scanning alone grants nothing, and the invitation stops working when the window closes. From a terminal, duckterm ducky pair does the same with a typed confirmation.
• Ducky keeps working when your Mac's address changes. New invitations use the Mac's local network name instead of a fixed IP, and the phone listener follows the Mac to a new private address without restarting your sessions. It still listens only on private network addresses, and only after you turn Ducky on.
• Phones paired with 0.4.189 or 0.4.190 keep working; their certificate and access are unchanged. A phone paired by IP address keeps using that address, so if the address goes away, pair it again.
• New invitations need Ducky TestFlight build 2 or later on the phone.

Downloads

Edition	Download (always the latest)	App
Lite	DuckTerm-Lite-macos-arm64.zip	DuckTerm Lite.app
Code	DuckTerm-Code-macos-arm64.zip	DuckTerm Code.app
Full	DuckTerm-Full-macos-arm64.zip	DuckTerm.app

Each also has a versioned copy (DuckTerm-<Edition>-0.4.191-macos-arm64.zip). All are notarized and need macOS 13 or later on Apple silicon. No schema changes. If you also use the pipx install: opening an app with no DuckTerm server running moves DuckTerm's hooks to that app, and duckterm install-hooks from the pipx install moves them back.

Other files

• duckterm-0.4.191-py3-none-any.whl: command line and server for pipx install
• SHA256SUMS, release.json (lists each asset with its edition)

DuckTerm 0.4.190

What's new

• Restarting DuckTerm no longer marks running agents as ended. Before, every server restart (including installing an update) marked each live session as ended, though its agent kept running in tmux. Idle sessions then showed grey and offline, and messages queued for them were cancelled. Now a restart only detaches the server; running sessions stay live and are re-adopted. When an agent really exits, its session still ends. Sessions already marked ended by an earlier restart come back on their next hook.

Downloads

Edition	Download (always the latest)	App
Lite	DuckTerm-Lite-macos-arm64.zip	DuckTerm Lite.app
Code	DuckTerm-Code-macos-arm64.zip	DuckTerm Code.app
Full	DuckTerm-Full-macos-arm64.zip	DuckTerm.app

Each also has a versioned copy (DuckTerm-<Edition>-0.4.190-macos-arm64.zip). All are notarized and need macOS 13 or later on Apple silicon. No schema changes. If you also use the pipx install: opening an app with no DuckTerm server running moves DuckTerm's hooks to that app, and duckterm install-hooks from the pipx install moves them back.

Other files

• duckterm-0.4.190-py3-none-any.whl: command line and server for pipx install
• SHA256SUMS, release.json (lists each asset with its edition)

DuckTerm 0.4.189

What's new

• Ducky, a read-only iPhone viewer (pilot). See your agents at a glance from your phone: which sessions are running, which are waiting for you, and recent activity. The phone can't type into terminals, run commands or see files or tokens.
• The Mac side is off until you set it up. It runs only on your private network (a private or loopback address; public and wildcard addresses are refused) over TLS that the phone pins. Phones join with a 10-minute invitation that you approve on the Mac, and you can revoke one at any time:
  • duckterm ducky setup --address <this Mac's private IP>
  • duckterm ducky invite, then duckterm ducky approve <device>
  • duckterm ducky devices, duckterm ducky revoke <device>, duckterm ducky disable
    Approved phones keep access until revoked. The bridge certificate lasts 365 days; after that, run setup --replace and pair again.

Downloads

Edition	Download (always the latest)	App
Lite	DuckTerm-Lite-macos-arm64.zip	DuckTerm Lite.app
Code	DuckTerm-Code-macos-arm64.zip	DuckTerm Code.app
Full	DuckTerm-Full-macos-arm64.zip	DuckTerm.app

Each also has a versioned copy (DuckTerm-<Edition>-0.4.189-macos-arm64.zip). All are notarized and need macOS 13 or later on Apple silicon. No schema changes. If you also use the pipx install: opening an app with no DuckTerm server running moves DuckTerm's hooks to that app, and duckterm install-hooks from the pipx install moves them back.

Other files

• duckterm-0.4.189-py3-none-any.whl: command line and server for pipx install
• SHA256SUMS, release.json (lists each asset with its edition)

DuckTerm 0.4.188

What's new

• Choose how DuckTerm's AI features run. Header menu → AI models. Pick Harness login (the default, unchanged and free: your Claude Code or Codex login) or Your API key (Anthropic, OpenAI, OpenRouter or an OpenAI-compatible URL). You also pick a fast and a deep model, used by Oracle, Relay, checkpoints and PR review cards.
• Your key stays yours. It is stored in the macOS Keychain and is never shown again, written to settings files or passed to agents. A custom endpoint's key works only with the URL it was verified against, and keys are never sent on redirects. Plain http:// is allowed only for localhost. If an API call fails, DuckTerm falls back to your harness login.

Downloads

Edition	Download (always the latest)	App
Lite	DuckTerm-Lite-macos-arm64.zip	DuckTerm Lite.app
Code	DuckTerm-Code-macos-arm64.zip	DuckTerm Code.app
Full	DuckTerm-Full-macos-arm64.zip	DuckTerm.app

Each also has a versioned copy (DuckTerm-<Edition>-0.4.188-macos-arm64.zip). All are notarized and need macOS 13 or later on Apple silicon. No schema changes. If you also use the pipx install: opening an app with no DuckTerm server running moves DuckTerm's hooks to that app, and duckterm install-hooks from the pipx install moves them back.

Other files

• duckterm-0.4.188-py3-none-any.whl: command line and server for pipx install
• SHA256SUMS, release.json (lists each asset with its edition)