record-session

Archive completed tasks by reading git history and updating .trellis workspace metadata.

Updated Aug 23, 2026

Search Tags:#automation #git #archive #journal #session #commit-management #trellis

Ready to run

npx skills add https://github.com/MaShouo/CodexAuthExchange --skill record-session-mashouo

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: record-session
Source: https://github.com/MaShouo/CodexAuthExchange/tree/main/.agents/skills/record-session
Command: npx skills add https://github.com/MaShouo/CodexAuthExchange --skill record-session-mashouo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams automatically record work progress after human-tested and committed code by deriving actionable session data and updating Trellis metadata.

Core Features & Use Cases

One-click session logging: Add a detailed session with a title, commit hashes, and a summary, and have the system automatically update the journal and index.
Task archival via git history: Read git log, git status, and git diff to identify completed work and archive it into .trellis/workspace metadata.
Safe, automated commits: All metadata commits are performed by the included scripts, reducing manual errors and keeping history clean.

Quick Start

Provide a session title, a list of commit hashes, and a concise summary to append a new session and update journal/index automatically.

Frequently Asked Questions about record-session

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I automatically archive git commits into a workspace journal?▼

To archive git commits into a workspace journal, you provide a session title, commit hashes, and a summary. The skill reads git history and invokes Python scripts to update .trellis metadata and journal files automatically.

What is the best way to record work progress after testing and committing code?▼

The best way to record work progress after testing is to log a session with its commit hashes and a concise summary. The skill then auto-commits updates to the .trellis workspace metadata, keeping history clean.

Do I need to manually edit .trellis metadata files to save a session?▼

No, you do not need to manually edit .trellis metadata files. Included Python scripts perform all metadata commits and update the journal and index automatically when you pass the correct arguments.

How does task archival via git history work for session management?▼

Task archival via git history works by reading git log, git status, and git diff to identify completed work. It then appends a session entry with commit hashes and summaries into the workspace index.

Can I use this session logging approach without prior git knowledge?▼

You need basic git knowledge to read git history and find commit hashes, but no advanced skills are required. The skill's Python scripts handle the actual metadata commits and workspace updates automatically.

Why should I use automated scripts for committing workspace metadata?▼

You should use automated scripts for committing workspace metadata to reduce manual errors and keep history clean. This ensures that session entries and journal updates are applied consistently across the .trellis workspace.