travsr repos
List and manage repositories in the Travsr registry.
Synopsis
travsr repos [flags]
Flags
| Flag | Description |
|---|---|
--prune | Remove registry entries whose database file no longer exists on disk |
--remove <name> | Remove a specific repo entry by name |
--json | Output as JSON |
Default output
Running travsr repos prints a table of all registered repositories:
+-----------------+----------------------------------------+------------+
| Name | DB Path | Exists |
+-----------------+----------------------------------------+--------------------+
| my-project | /Users/ak/my-project/.travsr/graph.db | yes |
+-----------------+----------------------------------------+--------------------+
| payment-service | /Users/ak/payment-svc/.travsr/graph.db | yes |
+-----------------+----------------------------------------+--------------------+
| old-api | /Users/ak/old-api/.travsr/graph.db | no (index deleted) |
+-----------------+----------------------------------------+--------------------+
1 stale entry (db missing); run `travsr repos --prune` to remove
Rows are sorted by name. Listing never changes the registry; stale entries are only reported.
Exists is yes when the .travsr/graph.db file is present on disk. When it is not, the column says why:
Exists | Meaning |
|---|---|
yes | The graph database is on disk |
no (index deleted) | An index was built for this repository once, and .travsr/graph.db has since gone |
no (never indexed) | The repository is registered, but no index run ever completed for it |
no (unknown) | The entry was written by an older travsr that did not track this, so the registry cannot say which of the two it is. It corrects itself on the next travsr init |
Pruning stale entries
Remove all entries whose database file is gone:
$ travsr repos --prune
pruned 1 stale repo(s):
- old-api
Removing a specific repo
$ travsr repos --remove old-api
removed repo 'old-api'
This removes the registry entry only. It does not delete the directory or the database file if it still exists.
JSON output
travsr repos --json
Returns an array of objects with name, db_path, exists and status fields. exists is true only for an indexed repository. status is one of indexed, index_missing, not_indexed or unknown, matching the table above.
VS Code
The Registered Repos panel in the VS Code sidebar shows the same information with one-click Prune stale and per-row remove buttons. See Repos Panel.