wallfacer
Terminal session manager for AI coding agent CLIs
TLDR
SYNOPSIS
wallfacerwallfacer new [dir] [--agent A] [--title T] [--project P] [--tag t]wallfacer resume|show|rm ref [options]wallfacer list [--project P] [--tag T] [--agent A] [--json]wallfacer search querywallfacer rename ref titlewallfacer tag add|rm ref tag...wallfacer project set|clear ref [name]wallfacer sync
DESCRIPTION
wallfacer indexes AI coding sessions from Claude Code, Cursor CLI, Kiro CLI, and Codex so you can name, tag, group, search, resume, or delete them. It is read-only toward the agents' own files: metadata lives in a local SQLite database under `~/.local/share/wallfacer/`.Bare wallfacer (when stdout is a TTY) opens a full-screen browser: session list, detail pane, fuzzy filter, and keys to resume, rename, tag, or trash. Subcommands are one-shot CLI for scripts; both fronts share the same index. Sync rescans disk automatically before commands (and via wallfacer sync).`<ref>` is an ID prefix or exact title; ambiguous refs list candidates instead of guessing. Sessions started outside wallfacer are picked up with no import step. rm moves to trash; only --purge deletes permanently (including multi-file agent layouts).
PARAMETERS
(no subcommand)
Open the interactive TUI browser (prints help if stdout is not a terminal).new [dir]
Start a session in dir (defaults interactively). --agent, --title, --project, --tag.resume ref
Reopen a session in its original working directory.list
List sessions newest first. Filters: --project, --tag, --agent (case-insensitive substring). --json for scripts.search query
Search titles, first prompts, directories, projects, and tags.show ref
Full details for one session.rename ref title
Set the display title.tag add|rm ref tag...
Add or remove tags.project set|clear ref
Assign or clear a project group.rm ref [--purge] [-f]
Move to trash, or permanently delete with --purge.sync
Force a rescan of agent session directories on disk.
CONFIGURATION
~/.local/share/wallfacer/
SQLite index and trash. Deleting this removes only wallfacer overlay metadata, not agent transcripts.WALLFACER_NO_UPDATE_CHECK=1
Disable the daily GitHub release notice (TUI footer / subcommand stderr).Agent scan roots include `~/.claude/projects/`, `~/.cursor/chats/`, `~/.kiro/sessions/cli/`, and `~/.codex/sessions/`.
CAVEATS
Does not modify agent session files for titles/tags — those live only in wallfacer's database. Full-text search of conversation content is on the roadmap (title/prompt search only today). OpenCode adapter is planned but not shipping yet.
HISTORY
wallfacer is an MIT-licensed Go tool by pradipta. The name references the Wallfacers of Liu Cixin's *The Dark Forest* — keepers of plans too sprawling for others to follow.
