epiq 0.7.4 → 0.7.6

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "epiq",
-	"version": "0.7.4",
+	"version": "0.7.6",
 	"license": "MIT",
 	"type": "module",
 	"description": "EPIQ - CLI based issue tracker",

package/readme.md

@@ -56,13 +56,27 @@ These design choices result in a system that is:
 
 ## Installation
 
-Install globally via npm:
+### Quick install
+
+A single self-contained binary — no Node.js required:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ljtn/epiq/main/install.sh | sh
+```
+
+Supports macOS (Intel & Apple Silicon) and Linux (x64 & arm64).
+
+Installs to `~/.local/bin` by default. Override with `EPIQ_INSTALL_DIR` (or `XDG_BIN_HOME`); pin a version with `EPIQ_VERSION=v0.7.5`.
+
+### Via npm
+
+If you already have Node.js (18+):
 
 ```bash
 npm install --global epiq
 ```
 
-Verify:
+### Verify
 
 ```bash
 epiq --version
@@ -157,26 +171,38 @@ Clear all filters with `:filter clear`
 
 ## MCP & Agent Compatibility
 
-Epiq provides a MCP (Model Context Protocol) server for agents to interact with, making it easy to plug into modern agent frameworks.
+Epiq provides a MCP (Model Context Protocol) server for agents to interact with, making it easy to plug into modern agent frameworks. The server is exposed by the `epiq-mcp` binary that ships with the package.
+
+### Claude Code
 
-To register Epiq with MCP-compatible clients (e.g. Claude Desktop), add it as a server using the `epiq-mcp` binary. Example configuration in your `~/.claude.json`:
+The reliable way to register the server is with the `claude mcp add` command — it writes to the correct config file for you, so you don't have to hand-edit JSON:
+
+```bash
+# Available everywhere (recommended)
+claude mcp add --scope user epiq -- npx -y -p epiq epiq-mcp
+
+# Or only in the current project
+claude mcp add epiq -- npx -y -p epiq epiq-mcp
+```
+
+Use `--scope user` to make Epiq available in every directory; omit it to register Epiq only for the current project. Verify the connection with `claude mcp list` (it should report `epiq … ✔ Connected`). MCP servers are loaded at startup, so **restart Claude Code** after adding the server before its tools become available.
+
+### Other MCP clients
+
+For clients that are configured by hand, add the following to the client's MCP config file — note this is **not** the same as Claude Code's `~/.claude.json`; Claude Desktop uses `claude_desktop_config.json`:
 
 ```json
-"mcpServers": {
-
-	"epiq": {
-		"command": "npx",
-		"args": [
-			"-y",
-			"-p",
-			"epiq",
-			"epiq-mcp"
-		]
+{
+	"mcpServers": {
+		"epiq": {
+			"command": "npx",
+			"args": ["-y", "-p", "epiq", "epiq-mcp"]
+		}
 	}
-
 }
 ```
 
+
 Once registered, agents can interact with your local Epiq instance through the MCP.
 
 ---