Skip to main content
← CLI Reference

travsr repos

List and manage repositories in the Travsr registry.

travsr repos output

Synopsis​

travsr repos [flags]

Flags​

FlagDescription
--pruneRemove registry entries whose database file no longer exists on disk
--remove <name>Remove a specific repo entry by name
--jsonOutput 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:

ExistsMeaning
yesThe 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.