# thegeneralist01

what it is

tern-projects is a project and session sidebar block (plugin.tern-projects.panel) for the Tern terminal. It replaces scattered terminal directory dumps with a deliberate, curated project library.

If you build software using multiple AI coding agents across your day, your session history lives in five or six distinct databases and directories: OMP, Claude Code, Codex, Pi, OpenCode, and Cursor. None of them share metadata, none talk to each other, and all of them treat projects as disposable working-directory strings.

tern-projects brings them all into one unified interface inside your terminal.

core capabilities

• curated "my projects" & multi-folder workspaces: create named projects with custom icons and multiple source directories. Designate one primary working directory for launching new chats while preserving associated submodules and repos.
• automatic discovery: automatically inspects historical session paths and aggregates agent history across all six harnesses without manual tagging.
• global pinned chats & recents: keep essential active threads pinned to the top of your sidebar regardless of age, with global recents across all agents.
• unified full-text search: search across worktrees, repositories, named projects, or global history with instant snippet previews.
• fresh-chat launching: start a fresh interactive session directly in your favorite coding harness with identity validation and multi-directory flags.
• local archiving & verified native deletion: archive sessions locally out of sight, or trigger fail-closed native source deletion with strict safety checks.

supported harnesses

indexes and launches interactive sessions across:

• OMP (oh-my-pi)
• Claude Code
• Codex CLI
• Pi coding agent
• OpenCode
• Cursor IDE (agent sessions)

source code, architecture notes, and installation instructions are on GitHub.