summaryrefslogtreecommitdiff
path: root/docs/index.md
diff options
context:
space:
mode:
authorspiperac <[email protected]>2026-06-15 06:42:13 +0200
committerspiperac <[email protected]>2026-06-15 06:42:13 +0200
commit0a477fd288d064d265395c88dbd0f261b723804e (patch)
tree9b129f8f41c907285b89ed8385679934bb59c14f /docs/index.md
Initial release
Diffstat (limited to 'docs/index.md')
-rw-r--r--docs/index.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000..ac0c0c1
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,20 @@
+# Shiv
+
+Shiv is a desktop MITM proxy for HTTP/HTTPS traffic inspection and web security testing. It runs natively on Linux, macOS, and Windows — written in Go with a Fyne UI, storing everything in a local SQLite database.
+
+The proxy listens on `127.0.0.1:9090` and handles plain HTTP, HTTPS via MITM (using a locally generated CA), HTTP/2, and WebSockets. All traffic passing through is recorded to disk and available in the History tab for the lifetime of the project.
+
+## Features at a glance
+
+- Full traffic capture with filtering, search, and per-row annotations
+- Request intercept with in-flight editing
+- Repeater for manual request replay, with per-tab send history and WebSocket support
+- Intruder for automated payload injection
+- Loot tab for tracking findings, with Markdown export
+- Decoder utility covering Base64, URL encoding, Hex, HTML entities, JSON, JWT, and common hashes
+- Scope control to limit which hosts are actively intercepted
+- Lua plugin API for scripting against the request/response pipeline
+
+## Where to start
+
+If you are setting Shiv up for the first time, go to [Getting Started](getting-started.md).