agent history — Resume recent AI coding sessions in the…

Pitch

Description

Comments

About this project

agent-history is a fast shell plugin that allows users to quickly resume their recent AI coding sessions. By reading execution logs and filtering out unnecessary paths, it presents a clean, user-friendly status dashboard of active projects. Features include Git integration, directory validation, and smart navigation, making it an ideal tool for developers leveraging AI coding assistants.

The agent-history plugin is a powerful command-line tool designed to streamline the resumption of recent AI coding sessions directly from the terminal. This plugin provides an efficient way to access execution logs and session databases from various AI coding assistants such as Claude Code, GitHub Copilot, and others, ensuring seamless navigation through recent projects.

Key Features

Relative Recency Timestamps: Displays when projects were last edited (e.g., 23h ago, 2d ago).
Git Branch Integration: Shows the current active Git branch for repositories and worktrees.
Directory Validation: Automatically excludes renamed or deleted projects from the dashboard.
SSH Auto-run Dashboard: Instantly presents the dashboard upon SSH login.
Adaptive Mobile Layout: Adjusts padding on narrow screens to maintain layout clarity.
Smart Path Shrinking: Condenses long directory paths to fit terminal width, preserving the leaf folder.
High-Performance: Utilizes a single find command and pure Bash built-ins to maintain rapid load times (under 200ms).
Quick Shell Navigation: Jump to project directories with ah <num>.

Usage Example

To display the recent projects, simply invoke the command:

ah

This will output a list of the most recent agent sessions, such as:

⚡ Recent Agent Sessions  
  1. ~/dev/chat-bot                           (main) (Claude · 2m ago)  
  2. ~/projects/next-auth                     (oauth-fix) (Aider · 1h ago)  
  3. ~/src/web-scraper                        (main) (Gemini · 3h ago)  
  4. ~/work/pricing-api                       (feature-rules) (Copilot · 1d ago)  
  5. ~/personal/dotfiles                      (main) (Claude · 3d ago)

To switch to a project directory directly, use:

ah 2

Configuration Options

The plugin allows customization with environment variables, enabling users to set the search paths for session histories and the limit for the number of projects displayed.

Porting to Other Shells

The core functionality of agent-history can be adapted for use with other shell environments. Submissions for implementations for shells such as Fish and PowerShell are welcomed, encouraging contribution to broaden the plugin's accessibility.

This plugin enhances productivity by simplifying shell navigation and providing a clear overview of recent AI-related coding efforts, making it an essential tool for developers who utilize AI coding assistants.