Skip to content

spyc v2.3.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 01:52
· 316 commits to main since this release
Immutable release. Only release title and notes can be modified.
878cc68

The short version

2.3 is Projects: several repos open in one spyc, each with its own columns,
tabs and agents. Along the way agy, Google's Antigravity CLI, gets promoted to
a first-class agent. About 25 features, 40 fixes, and a lot less terminal-tab
Tetris.

What's new

Projects

One spyc now holds several projects, each with its own columns, pane tabs,
config and agents. (#99)

  • Space n opens a directory as a project, Space j lists them to switch
    between, Space x closes one, and Space Space goes back to the last.
    (#751, #753, #759)
  • Space j also lists the projects you closed lately, and reopens one with
    its tabs. (#803)
  • Space ! (^a ! from the pane) takes you to the agent that needs you,
    whichever project it's in. The status bar shows each project's most urgent
    dot, and the window title counts the agents blocked in the others. (#780,
    #788, #790)
  • Work you start in a project finishes there, even after you've moved on:
    file operations, archive writes, image and git views, the graveyard and the
    inventory. (#715, #717, #719, #841)
  • spyc -r brings back every project. (#708, #765)
  • Your own settings for a project go in ~/.config/spyc/projects/, and
    :project config opens the file. (#794, #796)
  • An agent's spyc tools act on its own project, not the one you happen to be
    looking at. (#706, #757)

agy, promoted

agy now gets what Claude Code and Codex get.

  • ^a v pages its transcript, ^a g shows the images you've given it, and
    ^a t pages its thinking. (#830, #831, #848, #850)
  • With :agent hud on, its strip shows its latest reasoning while it works.
    (#846)
  • Its tool-approval and file-edit prompts turn the dot red, and gf, J and
    ^a u skip its input box and dialogs. (#819, #832, #851)
  • Its working dot stops when its turn does. agy redraws its spinner ten times
    a second while it works, so fifteen seconds of quiet means it's done,
    whatever its hooks say. And a cancel stays cancelled. (#853, #855)

Smaller additions

  • The $ subshell has a bar across the top, so you know spyc is still there
    underneath. (#696)
  • [pager] scrollback_line_numbers numbers the lines in ^a v. (#820)
  • Each plan window in the agent HUD says when it resets. (#690)

Fixed: the greatest hits

About 40 fixes in all; CHANGELOG.md has every one. These are the ones you'd
have noticed.

  • A typo in your .spycrc.toml, or a repo's that won't load, now costs you a
    warning instead of your whole config. (#826, #829)
  • A repo's .spycrc.toml can't set your clipboard command. (#728)
  • A worker that panics is reported and ends its own task, and leaves your
    terminal alone. (#837)
  • A Codex or Claude Code idle dot no longer flickers back to working when the
    agent redraws. (#835)
  • ^a v shows a long Claude Code session from its start. (#804)
  • The cursor stays on its file when the listing changes under it. (#813)
  • $ hands your terminal back the way it found it. (#710)
  • ^a c expands %, so tail -f % follows the file you're on. (#859)
  • An agent waiting on another's merge keeps its spyc connection, however long
    the wait. (#857)

What's next

2.4 starts with ^a v paging a transcript of any length straight from disk
(#845). Long sessions, we see you.


[2.3.0] - 2026-10-26

Features

  • agent-hud: Each plan window says when it resets (#690)
  • agent-hud: The rows hang from the activity dot on a dim bar (#693)
  • shell: Mark the $ subshell with a persistent top-row bar (#686) (#696)
  • app: Introduce Project and ProjectRuntime, behaviour-identical (#99) (#698)
  • mcp: Reads and driving tools act on the caller's project (#99) (#706)
  • session: Manifest v2 restores column a and marks running sessions (#99) (#708)
  • app: File-op results land in the project that started them (#99) (#715)
  • app: Archive work lands in the project that started it (#99) (#717)
  • app: Image, Lua and git-view results land in the project that started them (#99) (#719)
  • app: Open a project with Space n, and move between projects (#99) (#751)
  • app: Close a project with Space x (#99) (#753)
  • app: A project switcher on Space j (#99) (#759)
  • app: Spyc -r restores every project (#99) (#765)
  • app: Attention across projects: unseen dones, named notifications (#99) (#780)
  • app: Space ! and ^a ! go to the agent that needs you (#99) (#788)
  • app: Every open project's attention in the status bar, the title and Space j (#99) (#790)
  • app: The coordination dumps cover every open project (#99) (#792)
  • config: Per-project config files under ~/.config/spyc/projects (#99) (#794)
  • app: :project config opens the project's own config file (#99) (#796)
  • app: Space j lists recently-closed projects and reopens one with its tabs (#99) (#803)
  • agent: Parse agy hook metadata and waiting/cancel Stop states (#819)
  • config: [pager] scrollback_line_numbers for ^a v (#818) (#820)
  • agent: Agy transcript view, HUD tool pairing, and activity retention (#830)
  • agent: Support agy transcript image gallery and paste capture (#831)
  • agy: Exclude composer, footer, and approval chrome from pane navigation (#832)
  • agent: An agy tab's HUD shows its latest reasoning while it works (#846)
  • pane: ^a t pages an agy tab's thinking history (#850)

Bug Fixes

  • sessions: A short session id keeps its tail, as the agent strip does (#691)
  • agent-hud: Look up a Claude transcript again once its first prompt writes it (#692)
  • wiring: :hooks on! restarts the tab it was typed in, by id (#702)
  • vsplit: An agent's b that fails to open is reported as failed (#704)
  • shell: $ keeps the terminal's keyboard mode and its scroll region (#686) (#710)
  • app: The column guard sees columns reached through active_project() (#99) (#712)
  • app: Tabs and git walks in a project the user isn't in are served again (#99) (#721)
  • app: Agent status in a project the user isn't in is served again (#99) (#724)
  • app: A switch to another project brings it up to date (#99) (#726)
  • config: A repo's .spycrc.toml can't set the clipboard command (#99) (#728)
  • config: Spyc started in $HOME reads its rc once (#730)
  • config: A repo's scan pattern url opens only web pages (#99) (#732)
  • app: A closed project's work and agents, and unique homes (#99) (#734)
  • app: A closed project's archive work keeps unwritten changes and the user's cancel (#99) (#736)
  • archive: Read an archive once however often it is asked for (#738)
  • archive: A write owns its archive, and a clean-up takes only its own tree (#740)
  • archive: Keep an edit saved during a write, and guard archives inside archives (#744)
  • app: Config reload, config watching and Lua maps reach every project (#99) (#746)
  • app: A prompt raised over an editor or a pager takes the keys (#755)
  • mcp: The worktree tools act on the agent's project, not the directory the user is browsing (#757)
  • app: A pager opened over the editor takes the keys (#761)
  • app: The agent HUD follows the project switched to (#99) (#771)
  • session: A restore never resumes a conversation another running spyc holds (#99) (#798)
  • ui: The projects segment holds its width and parts its chips with a chevron (#99) (#800)
  • state: ^a v shows a long Claude session from its start (#804)
  • pager: A picker's keys act only on its own pager, not one opened over it (#806) (#812)
  • state: The cursor stays on its file when the listing changes under it (#62) (#813)
  • app: The startup-tab flash names a cwd that isn't a directory (#483) (#814)
  • app: Esc Space opens the shell history only from a shell prompt (#82) (#815)
  • config: An unknown key is skipped with a warning, not fatal to the whole config (#821) (#826)
  • config: A repo rc that can't load is skipped, not fatal to the user's own config (#827) (#829)
  • agent: A codex or claude idle report holds through the redraw after it (#835)
  • app: A worker that panics ends its task and is reported, and leaves the terminal as it is (#837)
  • app: Graveyard and inventory results land in the project that started them (#841)
  • agent: Bound agy transcript hydration and image indexing (#848)
  • agent: Anchor agy's approval scrape and output bounds to its live dialog and composer (#851)
  • agent: Agy's working report gives way to output timing after 15 seconds of quiet (#853)
  • agent: Agy's idle report holds through the redraws after Stop (#855)
  • mcp: The proxy waits out each call's server budget, so a long scope wait keeps the connection (#857)
  • pane: ^a c expands % in its command to the selection (#859)

Refactors

  • app: Introduce ProjectView, behaviour-identical (#99) (#699)
  • app: Route git and worktree results by project (#99) (#700)
  • app: Workers land results on channels, not shared slots (#825)
  • agent: Share the HUD metric types claude and agy both fill (#843)

Documentation

  • lua: Spyc.map binds one key, as the DSL does (#748)
  • changelog: Move releases before 2.0.0 to docs/changelog/1.x.md (#763)
  • agents: Cut AGENTS.md from 76 KB to 24 KB, and cap it (#766)
  • features: Split FEATURES.md into an overview and docs/features/ pages (#767)
  • config: Split CONFIGURATION.md into an overview and docs/config/ pages (#768)
  • features: Keep the agent pane page at the user's level (#772)
  • features: Keep the agents and MCP page at the user's level (#773)
  • features: Keep the browsing page at the user's level (#774)
  • features: Keep the pager page at the user's level (#776)
  • features: Keep the projects and sessions page at the user's level (#777)
  • features: Keep the shell and command-line page at the user's level (#775)
  • architecture: Bring the documentation contract up to date (#781)
  • features: Put the split, the second column and the mouse where they belong (#782)
  • src: Give the last 14 modules a module doc (#783)
  • Swap private repo paths in examples for made-up ones (#785)
  • Archive the Projects and 2.2 plans; UX 2.0 moves to 2.4 (#805)
  • %% is a literal % in a prompt (#7) (#811)
  • agent: Document Antigravity HUD, image gallery, and skill parity (#833)
  • agent: What gf, ^a u and :skill remove do, and three comments that were wrong (#842)
  • release: The 2.3 release notes, and a README that knows about Projects (#860)

Build & Tooling

  • homebrew: Name the tap App by client ID, and fail when its credentials are missing (#747)
  • apt: Fail the publish when the signing key is missing (#750)
  • deps: Bump the cargo-minor-patch group across 1 directory with 7 updates (#770)
  • lint: Require a SAFETY comment on every unsafe block (#822)
  • lint: Forbid unwrap in production code (#823)

Tests

  • wiring: Red case for a :hooks on! restart that reaches another tab (#701)
  • vsplit: Red cases for an agent's b that fails to open but is reported open (#703)
  • mcp: Red cases for per-project MCP (#99) (#705)
  • session: Red cases for manifest v2 (#99) (#707)
  • shell: Red cases for the $ handoff's terminal state (#686) (#709)
  • app: Red case for the column guard missing active_project() columns (#99) (#711)
  • statusline: The wrapper test ignores a reply the forwarder stopped waiting for (#713)
  • app: Red cases for file-op results landing in another project (#99) (#714)
  • app: Red cases for archive work landing in another project (#99) (#716)
  • app: Red cases for image, Lua and git-view results landing in another project (#99) (#718)
  • app: Red cases for tabs and git walks in a project the user isn't in (#99) (#720)
  • app: Red cases for agent status in a project the user isn't in (#99) (#722)
  • shell: The agent-env test reads its file only once it is written (#723)
  • app: Red cases for switching to another project (#99) (#725)
  • config: Red case for a repo's clipboard command (#99) (#727)
  • config: Red case for the home rc read twice in $HOME (#729)
  • config: Red case for a repo's scan pattern url (#99) (#731)
  • app: Red cases for a project that closes, and unique homes (#99) (#733)
  • app: Red cases for a closed project's archive work, MCP binding and refusals (#99) (#735)
  • archive: Red cases for two reads of one archive at once (#737)
  • archive: Red cases for a write or clean-up overlapping other work on an archive (#739)
  • archive: Red cases for an edit during a write, and writes of nested archives (#743)
  • app: Red cases for config reload, config watching and Lua maps in every project (#99) (#745)
  • app: Red cases for opening a project and moving between projects (#99) (#749)
  • app: Red cases for closing a project, and Space n's follow-ups (#99) (#752)
  • app: Red cases for a prompt raised over an editor or a pager (#754)
  • mcp: Red cases for the worktree tools acting on the agent's project (#756)
  • app: Red cases for the project switcher on Space j (#99) (#758)
  • app: Red cases for a modal pager opened over the editor (#760)
  • docs: Check every markdown link, and keymap examples in every doc (#762)
  • app: Red cases for -r restoring every project (#99) (#764)
  • app: Red case for the agent HUD following a project switch (#99) (#769)
  • docs: Guard the docs' shape — hub links, commands, module docs, hub size (#778)
  • app: Red cases for attention across projects (#99) (#779)
  • docs: Check prose references to a doc's sections (#784)
  • keymap: Every default key binding is in KEYBINDINGS.md and the ? overlay (#786)
  • app: Red cases for Space ! and ^a ! (#99) (#787)
  • app: Red cases for the projects segment, title count and switcher glyphs (#99) (#789)
  • app: Red cases for the coordination dumps grouped by project (#99) (#791)
  • config: Red cases for per-project config files (#99) (#793)
  • app: Red cases for :project config (#99) (#795)
  • session: Red cases for a restore resuming a held conversation (#99) (#797)
  • ui: Red cases for a projects segment that holds its width (#99) (#799)
  • app: Red cases for reopening a recently-closed project (#99) (#802)
  • state: Red cases for ^a v cutting a long Claude transcript short (#801)
  • pager: Red cases for picker keys acting on a pager opened over the picker (#806) (#807)
  • state: Red cases for the cursor leaving its file on a refresh or a sort (#62) (#808)
  • app: Red case for the startup-tab flash's unnamed cwd; a cluster test that bites (#483) (#809)
  • app: Red case for Esc Space in a : prompt opening the shell history (#82) (#810)
  • config: Red cases for an unknown key discarding the whole config (#821) (#824)
  • config: Red cases for a broken repo rc discarding the user's own config (#827) (#828)
  • agent: Red case for a codex or claude idle report yielding to the next redraw (#834)
  • app: Red cases for a panicking worker stranding its flight and the terminal (#836)
  • app: A guard that every worker landing is drained and wakes the loop (#838)
  • app: The wrapper-tab test reads the pane id only once it is written (#839)
  • app: Red cases for graveyard and inventory results landing in the project in view (#840)
  • app: The harness names its imports instead of globbing app/mod.rs (#844)
  • agent: Red cases for bounding agy's transcript hydration and image index (#847)
  • agent: Agy 1.4.7 screens captured live, and red cases for its approval and composer bounds (#849)
  • agent: Red cases for agy's working quiet window (#852)
  • agent: Red cases for agy's idle holding through redraws (#854)
  • mcp: Red cases for a slow reply ending the agent's MCP connection (#856)
  • pane: Red case for % in a ^a c tab's command (#858)

Miscellaneous

  • wiring: Drop 2.2's cleanup of older spycs' per-project wiring (#635) (#694)
  • pane: Remove the vt100 engine now that 2.2 has shipped (#453) (#695)
  • ci: Bump taiki-e/install-action from 2.87.27 to 2.87.29 in the github-actions group (#741)