v0.1.0 · MIT · Python 3.10+

Your developer workspace,
under control.

One CLI to audit env vars across every language, check the health of every repo in your workspace, and log your git activity across all projects at once.

pip install clude

Supports JS · TS · Python · Go · Ruby · Rust

Three tools. One command.

env audit

Static analysis across JS, TS, Python, Go, Ruby, and Rust. Find every env var your code references, validate against your .env, and auto-generate a .env.example.

  • env scanfind all env var usage in source
  • env validatediff .env against discovered vars
  • env generatewrite .env.example automatically

fleet health

Scan every git repo in a directory in seconds. See last commit, uncommitted changes, ahead/behind remote, stale branches - and optionally GitHub PRs and CI status.

  • fleet audithealth dashboard for all repos
  • fleet reportexport health report to markdown

log activity

What did you actually ship this week? Across 50 repos? clude log week answers that in under a second - grouped by repo, filtered to your commits, ready to paste into your standup.

  • log todaytoday's commits across all repos
  • log weekpast 7 days grouped by repo
  • log exportmarkdown report with --since

See it in action

env scan & validate

$ clude env validate ./my-project

Missing from .env  (1)
  x  STRIPE_SECRET_KEY

Defined but not in code  (1)
  !  LEGACY_API_KEY

Present and used  (3)
  ok DATABASE_URL
  ok JWT_SECRET
  ok REDIS_URL

1 required variable missing from .env

log week

$ clude log week ~/projects

Past 7 Days  23 commits · 5 repos

api-server (8 commits)
  Mon Jun 10  a3f8c2e  Add rate limiting
  Mon Jun 10  b91d4a7  Fix JWT expiry edge case
  Tue Jun 11  c44e8f1  Add health check endpoint

frontend (3 commits)
  Wed Jun 12  d77a2b9  Redesign dashboard
  Thu Jun 13  e12c5d3  Add dark mode toggle

env generate

$ clude env generate ./my-project
ok  Wrote 6 variables to .env.example

$ cat .env.example
# Generated by clude env generate

DATABASE_URL=
JWT_SECRET=
PORT=
REDIS_URL=
SMTP_HOST=
STRIPE_SECRET_KEY=

Try it live

Run commands against any public GitHub account directly in your browser - no install needed.

clude web terminal
Click an example or type a command below.
 
Examples (click to load):
$ clude fleet audit torvalds
$ clude log week torvalds
$ clude log month Cludes
$ clude env scan Cludes
 

Get started in seconds

Install

pip install clude

# optional: isolated install that's always on PATH
pipx install clude

Requires Python 3.10+. Works on Windows, macOS, and Linux.

Run it

clude --version

# if your shell can't find "clude", this always works:
python -m clude --version

The bare clude command needs Python's Scripts directory on your PATH - pip prints its location during install, or use pipx which sets it up for you. python -m clude works anywhere with no PATH setup.

Point it at your workspace

clude fleet audit ~/Documents
clude log week ~/Documents
clude env scan ~/Documents/my-project

# no PATH setup? prefix any command with python -m:
python -m clude fleet audit ~/Documents
python -m clude log week ~/Documents
python -m clude env scan ~/Documents/my-project

Every command works either way. On Windows cmd.exe use a full path like %USERPROFILE%\Documents - cmd doesn't expand ~. PowerShell, macOS, and Linux expand it fine.

Optional: GitHub enrichment

export GITHUB_TOKEN=ghp_...
export GITHUB_USER=yourname
clude fleet audit --github-user yourname
# or: python -m clude fleet audit --github-user yourname

Adds open PRs, issues, and CI status to the fleet table.