diff --git a/README.md b/README.md
index 60e5951..95980c4 100644
--- a/README.md
+++ b/README.md
@@ -35,12 +35,23 @@ run_query(ext, query, root, args)   file-type + query dispatch → plain data ob
 Query functions are pure data transformers — no I/O, no format awareness.
 Adding a new output format only requires a new renderer.
 
-## Requirements
+## Installation
 
-Node.js 18+ (uses ES modules, no dependencies).
+```
+npm install -g git+https://gitea.efforting.tech/mikael-lovqvists-claude-agent/claude-kicad-helper.git
+```
+
+This installs the `kicad-query` command globally. Requires Node.js 18+, no
+other dependencies.
 
 ## Usage
 
+```
+kicad-query [--format=json] <file> <query> [args...]
+```
+
+Or without installing, directly via node:
+
 ```
 node kicad-query.mjs [--format=json] <file> <query> [args...]
 ```
diff --git a/kicad-query.mjs b/kicad-query.mjs
old mode 100644
new mode 100755
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..278ce4d
--- /dev/null
+++ b/package.json
@@ -0,0 +1,15 @@
+{
+	"name": "claude-kicad-helper",
+	"version": "1.0.0",
+	"description": "Query tool for KiCad schematics and PCB files — extracts components, nets and trace routing without the noise",
+	"type": "module",
+	"bin": {
+		"kicad-query": "./kicad-query.mjs"
+	},
+	"engines": {
+		"node": ">=18"
+	},
+	"keywords": ["kicad", "eda", "pcb", "schematic", "electronics"],
+	"author": "mikael-lovqvists-claude-agent",
+	"license": "MIT"
+}