kamiyo-reality-fork-cli 0.4.2

Native CLI for KAMIYO Reality Fork — repo-aware launch stress tests and on-chain agent management.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

# kamiyo-reality-fork-cli

Native Rust CLI for KAMIYO Reality Fork — repo-aware launch stress tests.

No runtime dependencies. No Node.js. Single binary.

## Install

```bash
cargo install kamiyo-reality-fork-cli
```

## Usage

```bash
# score a repo and emit shareable artifacts
reality-fork run launch --repo .

# compare two runs
reality-fork run diff ./before/trace.json ./after/trace.json

# watch mode — re-run on every file change
reality-fork run watch --repo .

# share the latest run as a GitHub gist
reality-fork run share

# open report.html in the browser after a run
reality-fork run launch --repo . --open
```

The flagship workflow writes:

- `decision.md` — structured verdict with branches, evidence, and next moves
- `report.html` — interactive report matching the KAMIYO design system
- `trace.json` — full machine-readable run data

For monorepos, use `--focus <path...>` to pin the product surface you want to score.

## Agent Commands

Interact with on-chain KAMIYO agents directly from the CLI.

```bash
# query an agent by owner address
reality-fork agent info <owner-pubkey>

# list escrows for an agent
reality-fork agent escrows <owner-pubkey>

# derive the agent PDA for an owner
reality-fork agent pda <owner-pubkey>

# create a new agent on-chain (devnet)
reality-fork agent create --name "my-agent" --type trading --stake 0.1

# create on mainnet with custom keypair
reality-fork --cluster mainnet agent create --name "prod-agent" --type service --stake 1.0 --keypair ~/keys/agent.json

# deactivate an agent and reclaim stake
reality-fork agent deactivate --keypair ~/.config/solana/id.json
```

Use `--cluster` to target devnet (default), mainnet, localnet, or any RPC URL.
All read commands support `--output json` for machine-readable output.

## Configuration

Persist defaults so you don't have to pass flags every time.

```bash
# set default cluster
reality-fork config set cluster mainnet

# set default output format
reality-fork config set output json

# set default keypair path
reality-fork config set keypair ~/keys/agent.json

# view current config
reality-fork config show

# remove a default
reality-fork config unset cluster

# show config file location
reality-fork config path
```

Config is stored at `~/.config/kamiyo/reality-fork-cli/config.json`. CLI flags always override config defaults.

## Output

```
reality-fork run launch --repo .

  reality fork 分岐現界

  repo  kamiyo-protocol
  files 234 · TypeScript, Rust, TOML · solana-anchor, turborepo

  Immediacy     ████████████████░░░░   78%
  Clarity       ██████████████░░░░░░   68%
  Proof         ████████████████░░░░   82%
  Distribution  █████████████░░░░░░░   64%
  Shareability  ███████████████░░░░░   73%
  Trust         ██████████████████░░   88%

  Launch one impossible-to-miss workflow
  readiness 76%
```