Skip to content

Commit 3c3f502

Browse files
roodboiclaude
andcommitted
docs(readme): differentiate the environment, not the port
Comparison table: the duct-tape stack hack replaces (domains+TLS, secrets, run scripts, tunnels, persisted logs, parallel branches, workspaces) and why the pieces composing around one project model is the point. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent a83c0fb commit 3c3f502

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

README.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,26 @@ Machine surfaces are first-class: `--json` envelopes with stable error codes,
4545
`--no-interactive`, and agent instructions that sync themselves into
4646
AGENTS.md/CLAUDE.md, Cursor rules, and Codex skills.
4747

48+
## More than ports
49+
50+
Hack gets compared to local-domain tools like portless. Stable URLs are one slice.
51+
A project isn't running until *all* of it is running, and every other slice usually
52+
means another tool, another script, another README section:
53+
54+
| The job | The usual duct tape | With hack |
55+
| --- | --- | --- |
56+
| Local domains + trusted TLS | portless, mkcert, `/etc/hosts` edits | `https://myapp.hack`, CA trusted once |
57+
| Secrets & env | Doppler, `.env` files in Slack | encrypted values committed with the repo |
58+
| "How do I run this" | README + Makefile + tribal knowledge | `.hack/` config + `hack up` |
59+
| Tunnels, SSO, proxies | ad-hoc shell scripts in a terminal tab | declared lifecycle processes, cleaned up on `down` |
60+
| Logs | terminal scrollback, gone on restart | persisted history: `hack logs --loki --since 2h` |
61+
| Parallel branches | a second clone and port surgery | branch instances; worktrees isolate automatically |
62+
| Workspaces | hand-rolled tmux setups | `hack session` |
63+
64+
Each row is a tool you don't install or a script you don't maintain. The pieces
65+
compose because they share one model of the project — the same config that names
66+
your URL also resolves your env, starts your tunnels, and labels your logs.
67+
4868
## Install
4969

5070
```bash

0 commit comments

Comments
 (0)