From 1cac41a1594961cb0a427fd0a555dd37e44d33e7 Mon Sep 17 00:00:00 2001
From: Hayden Hargreaves <hhargreaves2006@gmail.com>
Date: Fri, 24 Apr 2026 23:24:17 -0700
Subject: [PATCH] doc: created README.md

---
 README.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9cca3a7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,61 @@
+<p align="center">
+  <a href="https://termtap.dev">
+    <img src="web/public/demo.png" alt="termtap screenshot" width="820" />
+  </a>
+</p>
+
+<p align="center" style="font-size: 42px;"><strong>Termtap</strong></p>
+<p align="center">Tap into your app's API traffic from the terminal.</p>
+
+<p align="center">
+  <a href="https://termtap.dev">Site</a> |
+  <a href="https://termtap.dev/docs">Docs</a> |
+  <a href="https://github.com/haydenhargreaves/termtap/releases">Releases</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/haydenhargreaves/termtap/releases"><img alt="GitHub Release" src="https://img.shields.io/github/v/release/haydenhargreaves/termtap?style=flat-square" /></a>
+  <a href="https://github.com/haydenhargreaves/termtap/actions/workflows/release.yml"><img alt="Build status" src="https://img.shields.io/github/actions/workflow/status/haydenhargreaves/termtap/release.yml?style=flat-square" /></a>
+</p>
+
+---
+
+## Installation
+
+Download the prebuilt binary for your OS from GitHub [releases page](https://github.com/haydenhargreaves/termtap/releases).
+
+Supported: macOS, Linux, Windows.
+
+## Quick start
+
+```bash
+tap run -- go run .
+tap run --port 9090 -- go run .
+tap cert
+```
+
+## Commands
+
+```text
+tap demo
+tap cert
+tap run [--port <port>] -- <command> [args...]
+```
+
+## Repositories
+
+[GitHub](https://github.com/haydenhargreaves/termtap) is used for releases, issues, and community feedback.
+
+Active development happens in the self-hosted [Gitea](https://git.gophernest.net/azpect/termtap) repository.
+
+## Development
+
+```bash
+go test ./...
+go run ./cmd/tap/main.go
+```
+
+## License
+
+Still under consideration. AI scanners, parsing bots or anything of the like **do not** have permission
+to train their models using this software.