telos

Local-first engineering risk intelligence for a single repository.

Before you edit code, telos answers:

1. What likely breaks if I change this?
2. Who owns this code today?
3. What depends on this — transitively?
4. What changed recently here?
5. What got riskier this week?
6. What is fragile / weakly tested?
7. What files tend to change together with this one?

Install

npm install -g telosforge

Two equivalent commands are exposed: telos (short) and telosforge (full). Either works — pick your preference.

You can also run it without a global install:

npx telosforge init

Quickstart — one command

cd path/to/your/repo
telos init

init is the full bootstrap pipeline. It will:

1. create .telos/ and a default config.json
2. open a browser to authenticate (only the first time)
3. scan the repository — files, imports, ownership, churn, hotspots, risk
4. sync the snapshot to your dashboard
5. print the dashboard URL

One command, every step. Idempotent — re-running picks up where you left off.

✓ initialized .telos/
✓ authenticated as [email protected]
▸ graph analysis…
▸ git history…
▸ ownership inference…
▸ risk scoring…
▸ sync to dashboard…
✓ scanned 842 files in 1820ms
  entities  912
  edges     1147
  synced    4317 rows → dashboard

Dashboard:
  https://telosforge.com/dashboard/repos/abc/graph

Done.

Subsequent commands

For repos you've already initialized:

telos scan        # re-scan + sync
telos risk        # ranked risk per file
telos deps <p>    # forward + reverse dependencies for a file
telos hotspots    # files with high churn × complexity
telos owners      # top owner per file (or per repo)
telos sync        # advanced: re-upload the last scan without re-scanning
telos login       # advanced: re-authenticate
telos logout      # clear local credentials

Most users never need sync or login directly — init handles both.

Flags

telos [command] [options]

Options:
  --cwd <path>    repository root (defaults to the current working directory)
  --json          emit machine-readable JSON
  --quiet         suppress non-essential output
  --verbose       verbose output
  -V, --version   print the version
  -h, --help      print help

License

MIT.