codex-skill

Shakes-tzd's avatarfrom Shakes-tzd

HtmlGraph session tracking and work continuity for Codex. Ensures proper activity attribution, feature awareness, and continuous work tracking across sessions.

⭐1stars🔀1forks📁View on GitHub🕐Updated Jan 3, 2026⬇️1downloads
[Memory and Context Management]

When & Why to Use This Skill

The HtmlGraph session tracking skill for Codex is a specialized developer tool designed to maintain work continuity and context across multiple AI-driven development sessions. By leveraging git hooks and feature-based attribution, it ensures that AI agents like Claude, Codex, and Gemini can seamlessly resume tasks, track file drifts, and maintain a consistent history of decisions and progress within a codebase.

Use Cases

  • Cross-Session Continuity: Resuming complex coding tasks where the AI assistant needs to recall previous progress, active features, and specific implementation decisions from past sessions.
  • Multi-Agent Handoffs: Facilitating seamless context transfer when switching between different AI models or platforms (e.g., moving from Claude Code to Gemini) without losing project state.
  • Feature-Based Development Tracking: Organizing work into specific feature branches or IDs to ensure all activity and code changes are accurately attributed to the correct development goal.
  • Drift Detection: Automatically identifying file changes made outside of the AI's current session to prevent context mismatch and ensure the agent is working with the most up-to-date codebase state.
namecodex-skill
descriptionHtmlGraph session tracking and work continuity for Codex. Ensures proper activity attribution, feature awareness, and continuous work tracking across sessions.
short-descriptionHtmlGraph session tracking for Codex

HtmlGraph Session Tracking

Description: HtmlGraph session tracking and work continuity for Codex. Ensures proper activity attribution, feature awareness, and continuous work tracking across sessions.

Commands:

  • $htmlgraph-status - Check current session and feature status
  • $htmlgraph-feature - List, start, or complete features
  • $htmlgraph-session - View session history and current work

Usage:

Check project status:

$htmlgraph-status

Start working on a feature:

$htmlgraph-feature start feat-abc123

Complete a feature:

$htmlgraph-feature complete feat-abc123

View session history:

$htmlgraph-session list

Features:

  • Automatic session tracking via git hooks
  • Feature-based work attribution
  • Cross-session continuity
  • Session resume detection
  • Drift detection for file changes

Requirements:

  • Python 3.10+
  • HtmlGraph installed (pip install htmlgraph>=0.8.0)
  • Git repository with .htmlgraph/ directory

Installation:

  1. Install HtmlGraph:
pip install htmlgraph>=0.8.0
  1. Initialize in your project:
cd your-project
htmlgraph init
  1. Copy this skill to Codex skills directory:
mkdir -p ~/.codex/skills/htmlgraph
cp -r packages/codex-skill/* ~/.codex/skills/htmlgraph/

Session Workflow:

  1. Session Start - Automatically detected when you begin working
  2. Feature Attribution - Activity linked to in-progress features
  3. Session Continuity - Resume context from previous sessions
  4. Session End - Auto-tracked via git hooks

Work Continuity:

HtmlGraph maintains state across sessions:

  • Previous session summary
  • Active features and their progress
  • File change tracking (drift detection)
  • Decision history and context

This enables seamless handoffs between:

  • Different AI assistants (Claude Code ↔ Codex ↔ Gemini)
  • Different sessions
  • Different agents/developers

See Also:

  • Full documentation: docs/WORKFLOW.md
  • Python SDK: docs/SDK_FOR_AI_AGENTS.md
  • Session management: uv run htmlgraph session --help