Skip to main content
Release: 0.1.0a3. Model calls: none. Result: a JSON description of a committed Git object. Complete installation first. Run the commands below from the directory containing your .venv folder. Git 2.45 or newer is required.

1. Get the public source

Use a new destination directory. The clone downloads source; the PeopleBot resolution command itself reads only local Git objects.
A detached checkout here deliberately selects the published distribution commit. You do not need to edit or commit anything.

2. Resolve one file

Windows PowerShell:
Linux:

3. Read the result

The output is one JSON object. Key values are: This identifies the file; it does not print its contents. To inspect the same committed content using Git:

4. Understand what stays fixed

Running the same command again uses the same commit even if main later changes. Uncommitted edits in the checkout do not become part of this State. Omitting --path resolves the commit itself; selecting a committed directory yields a tree. --repository is the identity recorded in the result. The resolver does not authenticate that label against the remote URL. Use the correct repository identity in your own configuration.

Next step

Use context selection to retrieve bounded file contents with their exact source references. If resolution fails, consult the error table.

Public reference

State resolver.