tapthat-server 0.1.0
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/README.md +49 -0
- package/dist/cli.js +3267 -0
- package/package.json +43 -0
package/README.md
ADDED
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# tapthat-server
|
|
2
|
+
|
|
3
|
+
Applies [TapThat](https://github.com/ljellevo/tapthat) comments to your repository with a
|
|
4
|
+
coding agent, beside your dev server, so a reviewer sees the change in their browser within
|
|
5
|
+
seconds.
|
|
6
|
+
|
|
7
|
+
> ⚠️ **Development tool. Never run it in production.** It accepts instructions that modify
|
|
8
|
+
> your repository. It refuses to start when `NODE_ENV=production`, needs an explicit
|
|
9
|
+
> `TAPTHAT_ENABLE=1`, and belongs in `devDependencies` only. See
|
|
10
|
+
> [security.md](https://github.com/ljellevo/tapthat/blob/main/docs/security.md).
|
|
11
|
+
|
|
12
|
+
```
|
|
13
|
+
TapThat extension ──Apply──▶ sidecar ──claude -p──▶ edits files in your working tree
|
|
14
|
+
├─▶ your dev server's HMR shows it (seconds)
|
|
15
|
+
└─▶ git commit (+ push, optional)
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## Quickstart
|
|
19
|
+
|
|
20
|
+
In the repository you want edited, on the branch the agent should commit to (not `main`):
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
npm i -D tapthat-server
|
|
24
|
+
npx tapthat-server init # config + secrets, prints what to paste into the extension
|
|
25
|
+
TAPTHAT_ENABLE=1 npx tapthat-server
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
It needs Node 20+, git, and the Claude Code CLI (`npm i -g @anthropic-ai/claude-code`). The
|
|
29
|
+
Docker image `ghcr.io/ljellevo/tapthat-server` includes all three and runs on Compose or a
|
|
30
|
+
single-container host such as Railway, where it clones the repository, starts the dev
|
|
31
|
+
server, and serves it all on one port.
|
|
32
|
+
|
|
33
|
+
## Commands
|
|
34
|
+
|
|
35
|
+
| | |
|
|
36
|
+
|---|---|
|
|
37
|
+
| `tapthat-server init` | Write `tapthat.config.json` and `.tapthat/secrets.env` |
|
|
38
|
+
| `tapthat-server` | Start (needs `TAPTHAT_ENABLE=1`) |
|
|
39
|
+
| `tapthat-server doctor` | Check config, repo, agent CLI and secrets |
|
|
40
|
+
| `tapthat-server run-file batch.json` | Run one batch without HTTP |
|
|
41
|
+
| `tapthat-server audit-prod` | Fail CI if the sidecar is in a production dependency tree |
|
|
42
|
+
|
|
43
|
+
## Documentation
|
|
44
|
+
|
|
45
|
+
- [Install guide](https://github.com/ljellevo/tapthat/blob/main/INSTALL.md): service side and client side, step by step
|
|
46
|
+
- [Setup reference](https://github.com/ljellevo/tapthat/blob/main/docs/setup.md): npx, Docker Compose, Railway, every setting
|
|
47
|
+
- [Security](https://github.com/ljellevo/tapthat/blob/main/docs/security.md) · [HTTP API](https://github.com/ljellevo/tapthat/blob/main/docs/api.md) · [Troubleshooting](https://github.com/ljellevo/tapthat/blob/main/docs/troubleshooting.md)
|
|
48
|
+
|
|
49
|
+
MIT licensed.
|