Skip to content

Repository files navigation

API Session Ledger

API Session Ledger is a local-first Windows application for recording evidence from AI-assisted coding and technical work sessions.

Version 0.1.0

The initial prototype records:

  • Session objective and project directory
  • Selected terminal or AI tool
  • Tool process start and exit events
  • File creation, modification, deletion, and rename events
  • SHA-256 hashes for files up to 25 MB
  • Git branch, commit, and status before and after the session
  • Sanitized append-only JSONL events
  • Session metadata and a deterministic Markdown summary

Current Limitation

Version 0.1.0 does not capture interactive terminal commands or terminal output.

It launches the selected terminal or AI CLI and independently observes project and Git activity. Managed terminal capture using Windows ConPTY is planned for the next phase.

The application does not use hidden keylogging, HTTPS interception, or silent credential collection.

Data Location

Session records are stored under:

%LOCALAPPDATA%\API Session Ledger\sessions\

Each session contains:

session.json
events.jsonl
summary.md

Build

.\build.ps1

The self-contained Windows x64 output is created under:

artifacts\publish\win-x64\

Roadmap

  1. Managed Windows ConPTY terminal capture
  2. Command and exit-code detection
  3. SQLite and full-text search
  4. Text file diffs and Git patches
  5. OpenAI-compatible local API proxy
  6. Anthropic and Grok adapters
  7. Browser transcript import
  8. Optional local Ollama summaries
  9. Evidence-linked project recall
  10. Encrypted export and backup

License

MIT License. See LICENSE.

About

Local-first Windows session ledger for AI coding, CLI, API, file, and Git activity.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages