Foreman CLI: Project Operations Toolkit

Remembering what you actually did across a dozen side projects is harder than doing the work itself. Project information and activity history scatter across files, scripts, and git logs, with no single record to draw a report from.

Foreman CLI centralizes workflow tracking, report generation, documentation, and GitHub scaffolding into one command-line interface backed by a single SQLite database. It logs work sessions and cross-project activity continuously, so daily, weekly, and per-project reports, with optional LLM-generated summaries, can be produced on demand instead of dug out of git history. It also generates Python codebase documentation and Mermaid architecture diagrams, and can scaffold a new GitHub repo with a .gitignore and CI/CD templates.

It's a Python CLI, installed via pip in editable mode and configured through a gitignored YAML file for GitHub credentials and an optional local LLM endpoint. Commands are grouped into tracking/reporting, documentation/diagrams, GitHub operations, and configuration. It's open source, MIT licensed, and public at github.com/Yamai7354/foreman-cli.