trajrl 2.1.0

Official Python CLI for TrajectoryRL (Bittensor SN11) — skill hub, live subnet state, validator analysis.

trajrl

The official Python CLI for TrajectoryRL — an open skill factory that uses Bittensor's distributed compute and incentive layer to produce state-of-the-art agent skills.

One install, one binary, two groups:

Group	What it does
trajrl skills ...	Browse and install agent skills published on trajrl.com into your local agent skill dirs (Claude Code, Cursor, Codex, Hermes, OpenClaw).
trajrl <subnet command>	Live SN11 state — winner, challenger, queue, validators, miners, packs, eval logs, deep validator analysis.

CLI output is Rich tables in a TTY and JSON when piped.

For generic Bittensor on-chain queries (metagraph, hyperparams) use btcli — the official Bittensor CLI.

Install

pip install trajrl

Live SN11 state (v6 winner-challenger)

trajrl challenge                    # in-flight epoch — challenger pack + per-validator scores so far
trajrl winner                       # current seated winner + last 5 change events
trajrl winner --history 20          # show more history
trajrl queue                        # pending eval queue
trajrl queue --eligible-only        # filter to submissions eligible right now

Validators / miners / packs

trajrl validators                   # roster table
trajrl validators --detail          # adds stake / weightTargets / benchVersion
trajrl miner --uid 63               # miner detail by UID
trajrl miner HOTKEY
trajrl pack HOTKEY PACK_HASH        # specific pack + eval results
trajrl submissions                  # recent submissions across the network
trajrl submissions --failed

Validator deep-dive

trajrl analyze                      # interactive validator picker
trajrl analyze --uid 5 --deep       # full report + drill-down into top miners
trajrl analyze HOTKEY --logs        # include recent eval logs

analyze produces, in one report:

1. Score Summary — miners evaluated, qualification rate, score stats
2. Rejection Breakdown — counts by rejection stage
3. Weight Distribution — parsed from cycle log, per-miner weights, gate, winner
4. Scenario Heatmap — pass rate, avg score per scenario
5. Top 15 Leaderboard — miners ranked by score
6. With --deep: per-miner drill-down

Eval logs (debug + audit)

trajrl logs --validator HOTKEY --limit 20
trajrl logs --eval-id 20260329_1430_w42 --show
trajrl logs --eval-id 20260329_1430_w42 --dump-to ./debug/

A miner eval archive contains:

SKILL.md                                 # miner's product
JUDGE.md                                 # scoring rubric used
metadata.json                            # final_score, delta, episode qualities
world.json                               # scenario context + salt
episodes/episode_N/
  testee_transcript.txt                  # agent's session log
  judge_transcript.txt                   # judge agent's grading log
  evaluation.json                        # per-criterion scores + summary
  episode.json                           # fixtures + instruction

Skill hub

trajrl skills list                              # all available skills
trajrl skills list --tag dev-tools --tag data   # filter by tags (AND)
trajrl skills search "code review"
trajrl skills show self-learning
trajrl skills add self-learning                 # install into every detected agent
trajrl skills add self-learning --agent cursor
trajrl skills sync                              # re-pull installed skills if newer upstream

Default agent skill directories (auto-detected by directory existence):

Agent	Path
Claude Code	~/.claude/skills/<slug>/SKILL.md
Cursor	~/.cursor/skills-cursor/<slug>/SKILL.md
Codex	~/.codex/skills/<slug>/SKILL.md
Hermes	~/.hermes/skills/<slug>/SKILL.md
OpenClaw	~/.openclaw/skills/<slug>/SKILL.md

Global options

Every command accepts:

Option	Description
--json / -j	Force JSON output (auto when piped)
--base-url	Override API base URL (env: TRAJRL_BASE_URL)
--version / -v	Print version and exit

JSON output

Piped output is JSON for every command — handy with jq:

trajrl skills list | jq '.skills[].slug'
trajrl winner | jq '.current.winner.uid'
trajrl queue --eligible-only | jq '.queue | length'
trajrl validators | jq '.validators[] | {uid, name, version, weightTargets}'

Skills (in this repo)

• skills/trajrl/SKILL.md — full agent-facing reference

Migration from v1.x

v1.x shipped three binaries: trajrl, trajectoryrl-inspector, bittensor-subnet-inspector. v2.0 collapses everything into one trajrl binary.

v1.x	v2.0
trajectoryrl-inspector status	trajrl validators
trajectoryrl-inspector download HOTKEY HASH	trajrl pack HOTKEY HASH
trajectoryrl-inspector download --uid N	trajrl miner --uid N
trajectoryrl-inspector analyze HOTKEY	trajrl analyze HOTKEY
trajectoryrl-inspector logs ...	trajrl logs ...
trajectoryrl-inspector submissions	trajrl submissions
bittensor-subnet-inspector metagraph -u 11	btcli subnet metagraph --netuid 11 (no longer in trajrl)
bittensor-subnet-inspector emission -u 11	btcli subnet hyperparameters --netuid 11 (no longer in trajrl)

New v2.0 commands: trajrl challenge, trajrl winner, trajrl queue (v6 dual-seat winner-challenger).

v2.1 (this release): removed trajrl chain group — it was redundant with btcli and pulled in the heavy bittensor SDK as a hard dependency. v2.1 has no chain-query commands; use btcli subnet metagraph / btcli subnet hyperparameters instead. Result: much lighter install (no substrate-interface, scalecodec, websockets, etc.).

Links

• Subnet repo: https://github.com/trajectoryRL/trajectoryRL — incentive mechanism, evaluation framework
• Bench: https://github.com/trajectoryRL/trajrl-bench — eval sandbox
• Website: https://trajrl.com — leaderboard, live subnet data, skill hub
• Public API: PUBLIC_API.md — read-only, no auth, base URL https://trajrl.com