$ txray param-history ClickWeight        # excerpt
param!      ClickWeight  home-mixer/params/param.rs
  2026-09-26T03:39:02Z  4c5cfe8f07f1  present at the start of the line, public default 0.4
  2026-09-29T03:06:30Z  a707cc27ba36  value changed: public default 0.4 -> 0.3  (old L322 sha256:b01734cae3e1124e at 4c5cfe8f07f1; new L329 sha256:4b5c535dbf7b2b6a)
  current: public default 0.3 at 77d431aabf40 (3 pinned commit(s) with a value)
...
note        values are public defaults at the cited commits, not production values; computed from pinned commits only (nothing fetched)

curl -fsSL https://raw.githubusercontent.com/solisolsoli/timelinexray/main/install.sh | sh
txray setup

$ curl -fsSL https://raw.githubusercontent.com/solisolsoli/timelinexray/main/install.sh | sh
os: Darwin
python: /usr/bin/python3 (3.12.4, SQLite 3.45.3 with FTS5 and the trigram tokenizer)
git: /usr/bin/git (2.54)
method: venv
package: git+https://github.com/solisolsoli/timelinexray@main
...
+ ~/.local/share/timelinexray/venv/bin/python -m pip install --disable-pip-version-check git+https://github.com/solisolsoli/timelinexray@main
+ ln -sf ~/.local/share/timelinexray/venv/bin/txray ~/.local/bin/txray
+ ~/.local/bin/txray --version
txray 0.11.0

TimelineXray is installed. Next step:
  txray setup

$ txray setup
commit     77d431aabf409ca1c1eed9bec7e2183f7c914e23
store      ~/.cache/timelinexray
pin        pinned (fetched from the upstream)
index      indexed: 2147 paths, 2140 files with indexed lines, 50387 symbols
elapsed    8.16 s

try next
  txray search 77d431a ClickWeight
  txray param ClickWeight --commit 77d431a
  txray show 77d431a README.md --lines 1-20

connect an agent (prints only; no client configuration is edited)
  claude mcp add --transport stdio timelinexray -- /path/to/bin/txray mcp serve --store /path/to/store
  txray setup --print-mcp-config json   (an mcpServers snippet)

Numbers in the code are public defaults at the pinned commit, not production values.

txray show 77d431a home-mixer/params/param.rs --lines 327-331 --anchor ClickWeight

commit     77d431aabf409ca1c1eed9bec7e2183f7c914e23
path       home-mixer/params/param.rs
lines      327-331 of 980  (bytes 7900-8053, 153 bytes)
blob       d2bad9d35b39ee11e20dcae58ef496ff860e3fed  sha256 47ad9a0b916049681e2a1561c8e418f2fa6f17f0ad00ea017d3cfa3e5de6ce1b
span       sha256 b923bbcbd2ff34ec1c61bfb2f24354d247ef9f77c914c53b092e4a33885fa8e9
endings    lf=5 crlf=0 unterminated=0
class      parsed-candidate (rust)
anchor     FOUND at line 329 (byte 7919)
note       numbers in the output above are public defaults at commit 77d431aabf409ca1c1eed9bec7e2183f7c914e23, not production values
----
    0.07
);
param!(ClickWeight, f64, "rust_home_mixer_click_weight", 0.3);
param!(OpenLinkWeight, f64, "rust_home_mixer_open_link_weight", 0.2);
param!(

uv tool install git+https://github.com/solisolsoli/timelinexray
pipx install git+https://github.com/solisolsoli/timelinexray

# read the script before running it
curl -fsSLO https://raw.githubusercontent.com/solisolsoli/timelinexray/main/install.sh
sh install.sh --dry-run     # prints every command, changes nothing
sh install.sh

flowchart LR
    U[(xai-org/x-algorithm)] -- "git fetch<br/>allowlisted URL only" --> M[Bare mirror<br/>pinned commits]
    M --> F[Manifest<br/>every path, hashed]
    M --> S[Exact spans<br/>blob bytes + SHA-256]
    M --> I[Code index<br/>SQLite FTS5, symbols]
    I --> P[Parameters<br/>public defaults + history]
    S --> L[Findings ledger<br/>hash chain]
    L -- "re-anchor on a newer commit" --> R{CURRENT / STALE /<br/>UNVERIFIABLE}
    M --> D[Diffs and digests<br/>local files]
    S & I & P & L --> X[Read-only MCP server<br/>stdio]

txray setup --print-mcp-config      # prints the exact `claude mcp add ...` line, absolute paths

# One command after installing: pin + index the tested commit, print next steps
txray setup                      # --latest pins upstream main instead; --no-index pins only
txray setup --print-mcp-config   # prints the `claude mcp add` line (or `json`); changes nothing

# Pin a commit (fetches from the allowlisted upstream only if the commit is not yet local)
txray pin 77d431aabf409ca1c1eed9bec7e2183f7c914e23

# Every path with its classification; --summary for counts and license files
txray manifest 77d431a --summary

# Exact lines 57-60 of a file, with blob and span hashes and an anchor check
txray show 77d431a xai-value-model/scoring.rs --lines 57-60 --anchor "fn apply"

# Only the span bytes, byte for byte
txray show 77d431a xai-value-model/scoring.rs --lines 57-60 --raw

# Native code index for a pinned commit, then search and list symbols
txray index 77d431a --coverage
txray search 77d431a "PhoenixScorer" --path "home-mixer/*" --limit 5
txray symbols 77d431a --name compute_weighted_score

# Parameter declarations with their public default at a commit, and over the pinned commits
txray param ClickWeight --commit 77d431a
txray param-history ClickWeight          # 0.4 -> 0.3 at a707cc2, both sides cited; no fetch

# Read-only MCP server for agents (stdio; see docs/mcp.md and docs/agents/)
txray mcp serve --store ~/.cache/timelinexray --ledger ~/.cache/timelinexray/findings
txray mcp tools --json

# Findings ledger (kept outside any git working tree: --ledger, $TXRAY_FINDINGS or <store>/findings)
txray findings add --actor author-1 --title "..." --claim "..." --evidence-class CODE \
    --status SUPPORTED --cite 77d431a xai-value-model/scoring.rs 65-119 compute_weighted_score
txray findings verify F-...        # span integrity only (INTACT / CHANGED / MISSING)
txray findings reanchor <newer-commit>   # freshness only: CURRENT / STALE / UNVERIFIABLE
txray findings stale               # what to re-review first: old and aligned spans, exact commands
txray findings verify --pin-cited  # pin the commits imported citations name, re-verify, re-anchor
txray findings review F-... --actor reviewer-1 --role reviewer --status SUPPORTED --rationale "..."
txray findings verify-log          # hash chain and HEAD

# Classified changes and a reviewed digest between two pinned commits (nothing is posted)
txray diff   4c5cfe8 a707cc2 --class parameter-default
txray digest 4c5cfe8 a707cc2 --out ~/txray-digests   # main digest + appendix; --ledger DIR for affected findings
txray update --out ~/txray-digests   # guarded fetch + pin + digest; schedule it yourself
txray update --out ~/txray-digests --reanchor --export ~/vault/txray
    # also re-anchors the ledger on the new head and refreshes the notes
    # (docs/updates.md, "Keeping the ledger fresh")

# Offline creator metrics from your own export (network disabled in this process)
txray metrics import export.csv --schema x-post-v1 --lang en --dump-header   # header mapping only: no data row read, nothing written
txray metrics import export.csv --schema x-post-v1 --lang en --out ~/private/txray-metrics \
    --captured-at 2026-09-30T18:00:00+09:00 --counts cumulative --scope combined
txray metrics rwe ~/private/txray-metrics
txray metrics reach ~/private/txray-metrics --horizon 24h

make test   # unittest suite; no test uses the network
make lint   # byte-compile src, tests and scripts; check the CI workflow
make ci     # exactly what CI runs: lint, hygiene, strict tests, build + clean-venv install