rh-cli 0.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- rh/__init__.py +12 -0
- rh/add.py +105 -0
- rh/cli.py +799 -0
- rh/config.py +308 -0
- rh/paths.py +96 -0
- rh/resume.py +186 -0
- rh/search.py +123 -0
- rh/skills/research-helper/SKILL.md +497 -0
- rh/tasks.py +221 -0
- rh/ui.py +128 -0
- rh/workflow.py +268 -0
- rh_cli-0.1.0.dist-info/METADATA +217 -0
- rh_cli-0.1.0.dist-info/RECORD +17 -0
- rh_cli-0.1.0.dist-info/WHEEL +5 -0
- rh_cli-0.1.0.dist-info/entry_points.txt +2 -0
- rh_cli-0.1.0.dist-info/licenses/LICENSE +21 -0
- rh_cli-0.1.0.dist-info/top_level.txt +1 -0
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: rh-cli
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: rh — orchestrate an AI research project end to end from the terminal
|
|
5
|
+
Author-email: Hitaishi V <hitaishi2222@gmail.com>
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/hitaishi2222/research-helper
|
|
8
|
+
Project-URL: Repository, https://github.com/hitaishi2222/research-helper
|
|
9
|
+
Project-URL: Issues, https://github.com/hitaishi2222/research-helper/issues
|
|
10
|
+
Project-URL: Roadmap, https://github.com/hitaishi2222/research-helper/blob/main/ROADMAP.md
|
|
11
|
+
Keywords: research,cli,orchestration,agents,skill,literature
|
|
12
|
+
Classifier: Development Status :: 3 - Alpha
|
|
13
|
+
Classifier: Environment :: Console
|
|
14
|
+
Classifier: Intended Audience :: Science/Research
|
|
15
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
16
|
+
Classifier: Operating System :: OS Independent
|
|
17
|
+
Classifier: Programming Language :: Python :: 3
|
|
18
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
19
|
+
Classifier: Topic :: Scientific/Engineering
|
|
20
|
+
Classifier: Topic :: Utilities
|
|
21
|
+
Requires-Python: >=3.9
|
|
22
|
+
Description-Content-Type: text/markdown
|
|
23
|
+
License-File: LICENSE
|
|
24
|
+
Requires-Dist: rich>=13
|
|
25
|
+
Provides-Extra: dev
|
|
26
|
+
Requires-Dist: pytest>=8; extra == "dev"
|
|
27
|
+
Requires-Dist: build>=1; extra == "dev"
|
|
28
|
+
Dynamic: license-file
|
|
29
|
+
|
|
30
|
+
# research-helper
|
|
31
|
+
|
|
32
|
+
**`rh` — orchestrate an AI research project end to end from the terminal.**
|
|
33
|
+
|
|
34
|
+
[](https://github.com/hitaishi2222/research-helper/actions/workflows/ci.yml)
|
|
35
|
+
[](https://pypi.org/project/rh-cli/)
|
|
36
|
+
[](https://pypi.org/project/rh-cli/)
|
|
37
|
+
[](LICENSE)
|
|
38
|
+
|
|
39
|
+
`rh` turns a research idea into a gated pipeline — config → intake → environment →
|
|
40
|
+
literature → plan → state → implement → critique → manuscript → close — with every
|
|
41
|
+
artifact, task, and decision kept in files an agent can read.
|
|
42
|
+
|
|
43
|
+
The **CLI is the product**. The **skill is additive**: it teaches an AI agent (pi,
|
|
44
|
+
Claude, Codex, …) how to drive `rh`, ask the user the right questions, and respect the
|
|
45
|
+
gates. Install the CLI, then optionally install the skill globally.
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
## Install
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# once published to PyPI (distribution name: rh-cli, command: rh)
|
|
53
|
+
uv tool install rh-cli
|
|
54
|
+
|
|
55
|
+
# or straight from git
|
|
56
|
+
uv tool install git+https://github.com/hitaishi2222/research-helper
|
|
57
|
+
|
|
58
|
+
# or from a clone
|
|
59
|
+
git clone https://github.com/hitaishi2222/research-helper
|
|
60
|
+
cd research-helper
|
|
61
|
+
uv tool install .
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
`pipx install rh-cli` and `pip install --user rh-cli` work too.
|
|
65
|
+
Verify with:
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
rh --version
|
|
69
|
+
rh describe
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### Install the skill (optional)
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
rh skill install # ~/.agents/skills/research-helper/
|
|
76
|
+
rh skill install --dest ~/.pi/agent/skills/research-helper # pi-specific location
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
Pi and other [Agent Skills](https://agentskills.io/specification) clients discover
|
|
80
|
+
`~/.agents/skills/` automatically. The skill is bundled in the wheel, so there is
|
|
81
|
+
nothing else to download.
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## Quickstart
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
rh init --slug my-project
|
|
89
|
+
rh env set agents.count=2 agents.backend=tmux \
|
|
90
|
+
literature.search=crw project.git=true
|
|
91
|
+
rh env show # config as a table, validated
|
|
92
|
+
rh phase 4 # gated: refuses to skip unmet exits
|
|
93
|
+
rh describe # the map an agent reads
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
The Orchestrator (your agent) interviews you for the environment and writes the
|
|
97
|
+
`## Environment` section of `ENV.md`; `rh` never probes or auto-fills binaries.
|
|
98
|
+
A tool on `PATH` does not mean this project should use it.
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## Commands
|
|
103
|
+
|
|
104
|
+
| Command | What it does |
|
|
105
|
+
|---|---|
|
|
106
|
+
| `rh init [--slug NAME] [--clean]` | create the `.rh/` workspace |
|
|
107
|
+
| `rh env show` | print config as a table + environment notes, validate |
|
|
108
|
+
| `rh env set KEY=VALUE ...` | set any key from the §2 schema (`rh env list`) |
|
|
109
|
+
| `rh env list` | every settable key, type, choices, help |
|
|
110
|
+
| `rh add note <heading> [-m BODY] [--file NAME]` | create/append a note file |
|
|
111
|
+
| `rh add literature <DOI-or-heading> [-m BODY]` | append under that DOI/heading in `LITERATURE.md` |
|
|
112
|
+
| `rh add layout <heading> [-m BODY]` | append to `OUTPUT_LAYOUT.md` (patterns + our layout) |
|
|
113
|
+
| `rh add gaps\|problem\|plan\|status\|manuscript <heading> [-m BODY]` | same for the other artifacts |
|
|
114
|
+
| `rh add log --role R --title T [-m BODY]` | §7 log file |
|
|
115
|
+
| `rh add task "title" [--id S01] [--phase N] [--owner ROLE] [--state idle\|working\|complete] [--verify CMD] [--deliverable FILE] [--depends-on S01,S02] [--kind build\|spike]` | add a board task |
|
|
116
|
+
| `rh search <query> [--max N]` | rg-first local search over `.rh/` + artifacts |
|
|
117
|
+
| `rh task set <id> <idle\|working\|complete>` | change a task state |
|
|
118
|
+
| `rh task list [--phase N] [--state S]` | filter the board |
|
|
119
|
+
| `rh tasks [--phase N]` | lanes + progress bars + table |
|
|
120
|
+
| `rh status` | header, phase rail, per-phase progress |
|
|
121
|
+
| `rh workflow` | display the agent-authored `.rh/workflow.mmd` as ASCII (`--tools`, `--example`, `--png`, `--svg`) |
|
|
122
|
+
| `rh phase <0-9>` | set the current phase — **gated**; `--force` records a waiver |
|
|
123
|
+
| `rh plan import [--dry-run]` | mirror `PLAN.md` steps into `tasks.json` |
|
|
124
|
+
| `rh resume` / `rh -r` | open the agent harness with a go-forward prompt |
|
|
125
|
+
| `rh skill install [--dest DIR] [--force]` | install the bundled skill globally |
|
|
126
|
+
| `rh describe [--json]` | the AI map: layout, phases, env keys, budget |
|
|
127
|
+
|
|
128
|
+
Global flags (before the subcommand): `--root DIR`, `--json`, `--version`.
|
|
129
|
+
Every command supports `--json` for agent reads — never parse the pretty UI.
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## How it works
|
|
134
|
+
|
|
135
|
+
```
|
|
136
|
+
0 CONFIG → 1 INTAKE → 2 ENVIRONMENT → 3 LITERATURE → 4 PLAN → 5 STATE
|
|
137
|
+
→ 6 IMPLEMENT → 7 CRITIQUE → 8 MANUSCRIPT → 9 CLOSE
|
|
138
|
+
↑ │
|
|
139
|
+
└── replan ──┘
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
Each phase has an **exit gate**; `rh phase` refuses to advance past an unmet one.
|
|
143
|
+
State lives in plain files, not a database:
|
|
144
|
+
|
|
145
|
+
```
|
|
146
|
+
<project>/
|
|
147
|
+
.rh/ machine mirror + logs, notes, managed PDFs, tasks
|
|
148
|
+
src/ implementation
|
|
149
|
+
results/ every number + the script that produced it
|
|
150
|
+
papers/ unmanaged PDFs
|
|
151
|
+
ENV.md config block + Orchestrator-written environment notes
|
|
152
|
+
PROBLEM.md goal, scope, success criteria, falsifier
|
|
153
|
+
OUTPUT_LAYOUT.md output skeleton + patterns from comparable papers
|
|
154
|
+
PLAN.md approved steps
|
|
155
|
+
STATUS.md truth
|
|
156
|
+
LITERATURE.md paper takes with DOI
|
|
157
|
+
GAPS.md implementation sourcing + upstream gaps
|
|
158
|
+
MANUSCRIPT.md write-up
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
`ENV.md` is the single config source; `.rh/env.json` mirrors it. `rh env set`
|
|
162
|
+
rewrites the JSON block and preserves whatever the Orchestrator wrote below it.
|
|
163
|
+
|
|
164
|
+
---
|
|
165
|
+
|
|
166
|
+
## The skill (additive)
|
|
167
|
+
|
|
168
|
+
`src/rh/skills/research-helper/SKILL.md` is the agent-facing half of the project.
|
|
169
|
+
It defines the phases, roles, gates, templates, and the ask-before list. The CLI
|
|
170
|
+
does not need it; the skill does not need to reimplement the CLI.
|
|
171
|
+
|
|
172
|
+
```bash
|
|
173
|
+
rh skill install
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
What the skill adds:
|
|
177
|
+
|
|
178
|
+
- **Roles** — Orchestrator, Literature, Researcher, Reviewer, Critique, Writer,
|
|
179
|
+
with a budget mapping for 1–4 agents.
|
|
180
|
+
- **Gates** — user approves the plan, critique veto, "no result without a file".
|
|
181
|
+
- **Templates** — `ENV.md`, `STATUS.md`, `OUTPUT_LAYOUT.md`, `PLAN.md` steps, logs.
|
|
182
|
+
- **Reading discipline** — one layout, a pattern tally, DOI anchors, no paraphrasing
|
|
183
|
+
unread papers.
|
|
184
|
+
|
|
185
|
+
---
|
|
186
|
+
|
|
187
|
+
## Development
|
|
188
|
+
|
|
189
|
+
```bash
|
|
190
|
+
uv venv
|
|
191
|
+
uv pip install -e ".[dev]"
|
|
192
|
+
uv run pytest -q
|
|
193
|
+
uv build # sdist + wheel in dist/
|
|
194
|
+
uv tool install dist/*.whl # smoke-test the installed command
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
Layout:
|
|
198
|
+
|
|
199
|
+
```
|
|
200
|
+
pyproject.toml
|
|
201
|
+
src/rh/ the CLI package
|
|
202
|
+
src/rh/skills/ the bundled skill (package data)
|
|
203
|
+
tests/ pytest smoke tests
|
|
204
|
+
docs/IDEA.md original design notes
|
|
205
|
+
ROADMAP.md where this is going
|
|
206
|
+
```
|
|
207
|
+
|
|
208
|
+
---
|
|
209
|
+
|
|
210
|
+
## Roadmap
|
|
211
|
+
|
|
212
|
+
See [ROADMAP.md](ROADMAP.md). Short version: publish to PyPI, harden the CLI,
|
|
213
|
+
then add real agent orchestration.
|
|
214
|
+
|
|
215
|
+
## License
|
|
216
|
+
|
|
217
|
+
[MIT](LICENSE) © 2026 Hitaishi V
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
rh/__init__.py,sha256=0dxus6Z20V2FT3YcOksuNba5Scs0ehvQr-ss14q-I8M,538
|
|
2
|
+
rh/add.py,sha256=EwI219FGle-SB-zsTrJRD9e7wIRoQX6MmOc_4CoOOk4,4090
|
|
3
|
+
rh/cli.py,sha256=w-OivfP-tlFI1R_mMSia5zQT_TRvilcI484AJofBUes,36672
|
|
4
|
+
rh/config.py,sha256=ScjGkEfRz5lHBCcsI0qTb6CqpdmGqhzHZHmGIatVqFc,12370
|
|
5
|
+
rh/paths.py,sha256=e69yrkVAf2BVQ6b3nwscOFhGOrgw6kgtu3GHa6eVrLw,2728
|
|
6
|
+
rh/resume.py,sha256=0AMmKZitw_03XORYDR6szB7rZ2B7JOPkdGX7S4KYWy4,8268
|
|
7
|
+
rh/search.py,sha256=Kqdzx8ilkOIR3qpbZMzxn3NpCKWqfjE6ef0UIYvgcCw,4080
|
|
8
|
+
rh/tasks.py,sha256=7zFT340Uomnz92XJ5wpIOVg8X0wB_sxBCB8AiE_d4MQ,7508
|
|
9
|
+
rh/ui.py,sha256=OupQeBP_bG0nRim_-yQpwXaWD-rKN0v8skTkCpvs0jU,4447
|
|
10
|
+
rh/workflow.py,sha256=MkKo6feS2Zr7Wfxyrv0Lbqoit2FNhIhjU6PW5jQQNGY,10972
|
|
11
|
+
rh/skills/research-helper/SKILL.md,sha256=6HDXhGcX88bM568iuMjvSNB8eqJFDQ9DENb_NjD6gN4,26537
|
|
12
|
+
rh_cli-0.1.0.dist-info/licenses/LICENSE,sha256=9-FmfuPuwDnf0l8LqAV-U3GGJiPzWt72PRO0yqfcPaM,1067
|
|
13
|
+
rh_cli-0.1.0.dist-info/METADATA,sha256=MEZoju-QGXI8szvK1WYUd0LLWs18I_83_uM0RO0EZ4U,8143
|
|
14
|
+
rh_cli-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
|
|
15
|
+
rh_cli-0.1.0.dist-info/entry_points.txt,sha256=RCi3gM5APmiu5E-UbEDDYgIvldjHnPFlQ0-oAi3Cywg,35
|
|
16
|
+
rh_cli-0.1.0.dist-info/top_level.txt,sha256=WWoMRauMYwpFM0ErdJ48LLYpZiBIQslQCaAkwFsZe4s,3
|
|
17
|
+
rh_cli-0.1.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Hitaishi V
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
rh
|