gh-logger

Log decisions, sessions, and progress to JSONL via GitHub Copilot CLI.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/nategarelik/claude-config-ultimate --skill gh-logger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-logger
Source: https://github.com/nategarelik/claude-config-ultimate/tree/main/skills/gh-logger
Command: npx skills add https://github.com/nategarelik/claude-config-ultimate --skill gh-logger

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of manually tracking decisions, progress, and creating audit trails across AI sessions, especially for team visibility and compliance. It ensures no critical information is lost.

Core Features & Use Cases

  • Manual Decision Logging: Explicitly record important architectural or implementation decisions and their rationale.
  • Progress Tracking: Log milestones, blockers, and task completions to maintain project momentum and provide clear updates.
  • Audit Trails: Create a comprehensive, searchable history of AI interactions and tool usage for compliance, post-mortems, or future reference.
  • Use Case: After a complex debugging session, use this skill to log the root cause, the fix applied, and verification steps, ensuring team members can quickly understand the resolution without needing to re-trace the entire conversation.

Quick Start

Use the gh-logger skill to log this decision: 'Refactored user authentication to use JWT tokens for improved security and scalability.'

Frequently Asked Questions about gh-logger

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

FAQPage Schema
How do I create an audit trail for decisions and progress in my development workflow?

Audit trails capture a searchable history of decisions, rationale, and milestones across sessions. gh-logger automatically logs session history to ~/.claude/logs/ and lets you manually record architectural decisions, implementation choices, and progress updates as structured JSONL entries, ensuring team visibility and compliance without manual documentation overhead.

Can I log decisions and track progress automatically with the GitHub Copilot CLI?

Yes. gh-logger integrates with the GitHub Copilot CLI via the session-logger hook for automatic session logging and supports manual decision and progress logging through gh copilot suggest, creating timestamped, structured records of your work without extra steps.

What's the best way to document debugging sessions and solutions for my team?

After resolving issues, use gh-logger to log the root cause, fix applied, and verification steps as a single decision entry. Team members gain instant access to the resolution rationale and context, eliminating the need to retrace entire debugging conversations and accelerating future troubleshooting.

How do I maintain compliance and create searchable records of AI tool usage?

gh-logger stores all session data, decisions, and progress updates locally in ~/.claude/logs/ as JSONL, creating a comprehensive, searchable audit trail. Optional GitHub CLI integration enables team-visible tracking while keeping sensitive data in local, privacy-conscious storage.

Does logging work across multiple sessions and support episodic memory?

Yes. gh-logger maintains continuous session history across multiple interactions and integrates with episodic-memory systems, so decision context and progress updates persist and inform future sessions without manual re-entry.

What happens if I need to track blockers and milestones without slowing down my workflow?

gh-logger logs milestones and blockers through structured JSONL entries without interrupting development. The lightweight logging mechanism captures task completions and obstacles in real time, maintaining project momentum while building a clear, queryable progress record.