Commands¶

Complete reference for all Gity commands.

Repository Commands¶

register¶

Register a repository for acceleration.

gity register <path>

Arguments:

<path> — Path to the Git repository

Example:

gity register /path/to/repo
gity register .  # Current directory

unregister¶

Stop accelerating a repository and clean up.

gity unregister <path>

Arguments:

<path> — Path to the registered repository

Example:

gity unregister /path/to/repo

list¶

Show all registered repositories.

gity list [--stats]

Options:

--stats — Include resource usage statistics (CPU, memory, cache size, job queue)

Example:

gity list
gity list --stats

status¶

Get a fast status summary for a repository.

gity status <path>

Returns clean/dirty state and changed paths using cached metadata.

Example:

gity status /path/to/repo

health¶

Run diagnostic checks on a repository.

gity health <path>

Output includes:

Watcher status
Generation token
Dirty path count
Scheduled jobs
Resource throttling status
Sled database integrity

Example:

gity health /path/to/repo

changed¶

List files changed since a specific token.

gity changed <path> [--since <token>]

Options:

--since <token> — Watcher token (defaults to last status token)

Example:

gity changed /path/to/repo
gity changed /path/to/repo --since 42

prefetch¶

Trigger background fetch and maintenance.

gity prefetch <path> [--now]

Options:

--now — Run immediately instead of waiting for the scheduler

Example:

gity prefetch /path/to/repo
gity prefetch /path/to/repo --now  # Immediate

maintain¶

Force maintenance tasks regardless of idle timers.

gity maintain <path>

Runs commit-graph refresh, GC, and other maintenance.

Example:

gity maintain /path/to/repo

logs¶

Stream daemon logs for a repository.

gity logs <path> [--follow] [--limit N]

Options:

--follow — Tail live output
--limit N — Number of entries (default: 50)

Example:

gity logs /path/to/repo
gity logs /path/to/repo --follow
gity logs /path/to/repo --limit 100

events¶

Stream file watcher events in real-time.

gity events

Subscribes to the daemon's PUB socket and shows notifications until interrupted.

Example:

gity events
# Press Ctrl+C to stop

Daemon Commands¶

daemon run¶

Start the daemon in the foreground. Press Ctrl+C to exit.

gity daemon run

daemon health¶

Fetch a health summary from the running daemon (repo count, pending jobs, uptime, per-repo generations).

gity daemon health

daemon queue-job¶

Manually enqueue a background job for a repo.

gity daemon queue-job <path> <prefetch|maintenance>

daemon start¶

Start the daemon as a background process.

gity daemon start

Used by installers and gity tray. Most commands auto-start the daemon if needed.

daemon stop¶

Stop the running daemon gracefully.

gity daemon stop

daemon oneshot¶

Start daemon, service jobs for a repo, then exit.

gity daemon oneshot <path>

Useful for CI/CD pipelines.

Example:

gity daemon oneshot /path/to/repo
git status
git diff --cached

daemon metrics¶

Print current resource metrics.

gity daemon metrics

Shows CPU, RSS, file descriptors, cache usage, and job queue depths.

Database Commands¶

Gity stores metadata, queues, and logs in a local sled database under $GITY_HOME/data/sled. The db subcommands operate on that store.

db stats¶

Show database statistics (file sizes and entry counts).

gity db stats

db compact¶

Compact database files to reclaim space.

gity db compact

db prune-logs¶

Prune old log entries from persistent storage.

gity db prune-logs [--older-than <DAYS>]

--older-than <DAYS> — Remove entries older than this many days (default: 7).

System Tray¶

tray¶

Launch the system tray UI.

gity tray

The tray menu provides:

Info — Window with repo status, watcher health, queue depths
Exit — Equivalent to gity daemon stop

If the daemon isn't running, gity tray starts it automatically.

Internal Commands¶

fsmonitor-helper¶

Git fsmonitor protocol implementation.

gity fsmonitor-helper [<version>] [<token>] [--repo <path>]

Note

This command is invoked by Git, not directly by users. It implements the fsmonitor protocol to report changed files.

Arguments / options:

<version> — Protocol version (1 or 2, default 2)
<token> — Opaque token from previous response
--repo <path> — Override the repo path (useful when invoked outside the working tree)

Command Behavior¶

Auto-start daemon — CLI commands automatically start the daemon if not running
IPC communication — Commands communicate with the daemon via async-nng sockets
Streaming output — Commands like events and logs --follow stream until interrupted