better-grill 0.3.0 → 0.3.2
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.
- package/.claude-plugin/plugin.json +1 -1
- package/README.md +61 -40
- package/package.json +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "better-grill",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.2",
|
|
4
4
|
"description": "Run grill sessions in a local browser UI instead of the terminal: rounds of questions with options and a recommendation, a discussion thread per question, driven by your open Claude Code session.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Jakub Stastny",
|
package/README.md
CHANGED
|
@@ -1,74 +1,95 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/devbaj-stastny-jakub/better-grill/main/.github/assets/hero.png" alt="better grill, the UI for the grilling skill: grilling without the terminal mess. Rounds of questions, Claude's pick on each, a discussion thread per question.">
|
|
3
|
+
</p>
|
|
2
4
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
5
|
+
<p align="center">
|
|
6
|
+
<a href="https://www.npmjs.com/package/better-grill"><img src="https://img.shields.io/npm/v/better-grill?color=f97316" alt="npm"></a>
|
|
7
|
+
<a href="LICENSE"><img src="https://img.shields.io/npm/l/better-grill?color=f97316" alt="license"></a>
|
|
8
|
+
<a href="https://nodejs.org"><img src="https://img.shields.io/node/v/better-grill?color=f97316" alt="node"></a>
|
|
9
|
+
</p>
|
|
6
10
|
|
|
7
|
-
|
|
11
|
+
<p align="center"><b>Matt Pocock's <a href="https://github.com/mattpocock/skills"><code>grilling</code></a> skill, in a real UI.<br>Rounds, discussions, one clean send, and no mess in your terminal.</b></p>
|
|
8
12
|
|
|
9
|
-
|
|
13
|
+
---
|
|
10
14
|
|
|
11
|
-
|
|
15
|
+
## Two ways to grill
|
|
12
16
|
|
|
13
|
-
|
|
17
|
+
<table>
|
|
18
|
+
<tr>
|
|
19
|
+
<td width="50%" valign="top">
|
|
14
20
|
|
|
15
|
-
|
|
16
|
-
- **A discussion thread per question.** Push back on one question without derailing the rest; Claude can reword, resolve, drop or add questions from the talk.
|
|
17
|
-
- **Answer at your own pace.** Lock in questions in any order, change your mind, then send the whole round at once.
|
|
18
|
-
- **Runs on your Claude Code session.** Uses your existing subscription. No API key, no hosted service.
|
|
21
|
+
**Grill a plan**
|
|
19
22
|
|
|
20
|
-
|
|
23
|
+
```
|
|
24
|
+
/better-grill:better-grill <plan>
|
|
25
|
+
```
|
|
21
26
|
|
|
22
|
-
|
|
23
|
-
- [Node.js](https://nodejs.org) 20 or newer on your `PATH`
|
|
24
|
-
- The `grilling` skill from [mattpocock/skills](https://github.com/mattpocock/skills). better-grill brings the UI; `grilling` brings the method.
|
|
25
|
-
- For the docs variant, also `domain-modeling` from the same repo.
|
|
27
|
+
Claude grills your plan round by round until every decision is settled, then sums them up.
|
|
26
28
|
|
|
27
|
-
|
|
29
|
+
</td>
|
|
30
|
+
<td width="50%" valign="top">
|
|
28
31
|
|
|
29
|
-
|
|
32
|
+
**Grill with docs**
|
|
30
33
|
|
|
31
34
|
```
|
|
32
|
-
/
|
|
33
|
-
/plugin install better-grill@better-grill
|
|
35
|
+
/better-grill:better-grill-docs <plan>
|
|
34
36
|
```
|
|
35
37
|
|
|
36
|
-
|
|
38
|
+
The same grill, and Claude keeps a glossary (`CONTEXT.md`) and ADRs up to date as decisions settle, like `grill-with-docs`.
|
|
39
|
+
|
|
40
|
+
</td>
|
|
41
|
+
</tr>
|
|
42
|
+
</table>
|
|
37
43
|
|
|
38
|
-
|
|
44
|
+
For example:
|
|
39
45
|
|
|
40
46
|
```
|
|
41
|
-
/better-grill:better-grill
|
|
47
|
+
/better-grill:better-grill a CLI that syncs my dotfiles across machines
|
|
42
48
|
```
|
|
43
49
|
|
|
44
|
-
|
|
50
|
+
Your browser opens on the session, and Claude's first round of questions lands there.
|
|
51
|
+
|
|
52
|
+
## Install
|
|
53
|
+
|
|
54
|
+
In Claude Code:
|
|
45
55
|
|
|
46
56
|
```
|
|
47
|
-
/
|
|
57
|
+
/plugin marketplace add devbaj-stastny-jakub/better-grill
|
|
58
|
+
/plugin install better-grill@better-grill
|
|
48
59
|
```
|
|
49
60
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
4. When every question is locked in, **Send to Claude**. The next round builds on your answers.
|
|
54
|
-
5. When nothing is left open, Claude posts a summary of every decision. Confirm it, or say what's wrong and the grilling continues.
|
|
61
|
+
You also need [Node.js](https://nodejs.org) 20+ and the [`grilling`](https://github.com/mattpocock/skills) skill; the docs variant also uses `domain-modeling` from the same repo. better grill brings the UI, the skills bring the method.
|
|
62
|
+
|
|
63
|
+
## What you get
|
|
55
64
|
|
|
56
|
-
|
|
57
66
|
|
|
58
|
-
|
|
67
|
+
<table>
|
|
68
|
+
<tr>
|
|
69
|
+
<td width="33%" valign="top"><b>One question at a time</b><br>Rounds step through their questions, with Claude's context, trade-offs and tables.</td>
|
|
70
|
+
<td width="33%" valign="top"><b>Claude's pick on each</b><br>Take it, choose another option, write your own answer, or add a note.</td>
|
|
71
|
+
<td width="33%" valign="top"><b>A thread per question</b><br>Push back on one question; Claude rewords, resolves, drops or adds questions.</td>
|
|
72
|
+
</tr>
|
|
73
|
+
<tr>
|
|
74
|
+
<td width="33%" valign="top"><b>Lock in, then send</b><br>Answer in any order, change your mind, send the round when it's settled.</td>
|
|
75
|
+
<td width="33%" valign="top"><b>A summary at the end</b><br>Every decision in one place. Confirm it, or keep grilling.</td>
|
|
76
|
+
<td width="33%" valign="top"><b>Keyboard first</b><br><kbd>↑</kbd> <kbd>↓</kbd> walk the options, <kbd>Enter</kbd> locks in, <kbd>D</kbd> opens the discussion, <kbd>[</kbd> folds the sidebar.</td>
|
|
77
|
+
</tr>
|
|
78
|
+
</table>
|
|
59
79
|
|
|
60
|
-
##
|
|
80
|
+
## Built into Claude Code
|
|
61
81
|
|
|
62
|
-
-
|
|
63
|
-
-
|
|
64
|
-
- The
|
|
65
|
-
-
|
|
82
|
+
- **Part of the session you're in.** One command from your current Claude Code session. No accounts, no API keys, nothing to set up.
|
|
83
|
+
- **Live, both ways.** Your answers reach Claude the moment you send them, and its replies in a discussion show up as soon as it writes them.
|
|
84
|
+
- **Claude knows your project.** The grill runs in the same conversation, so Claude asks with your code and everything you've discussed in mind.
|
|
85
|
+
- **Your terminal stays quiet.** The whole grill happens in the browser; the terminal just shows Claude at work.
|
|
86
|
+
- **Several grills at once.** Every Claude Code session gets its own grill in its own tab.
|
|
66
87
|
|
|
67
|
-
|
|
88
|
+
Curious about the internals? [ARCHITECTURE.md](ARCHITECTURE.md).
|
|
68
89
|
|
|
69
90
|
## Contributing
|
|
70
91
|
|
|
71
|
-
Issues and pull requests welcome. Dev setup: [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
92
|
+
Issues and pull requests welcome. Dev setup, demo and screenshots: [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
72
93
|
|
|
73
94
|
## License
|
|
74
95
|
|