diff --git a/Makefile b/Makefile
index 23925fd..b21d257 100644
--- a/Makefile
+++ b/Makefile
@@ -1,7 +1,7 @@
 # Flynn Makefile
 # Self-hosted personal AI agent
 
-.PHONY: build dev start stop restart status logs tui tui-fs tui-dev test test-run lint typecheck help daemon-start daemon-stop daemon-restart daemon-status daemon-logs enable disable llama-start llama-stop llama-restart llama-status llama-logs llama-enable llama-disable
+.PHONY: build dev start stop restart status logs tui tui-fs tui-dev test test-run lint typecheck check help deps install daemon-start daemon-stop daemon-restart daemon-status daemon-logs enable disable llama-start llama-stop llama-restart llama-status llama-logs llama-enable llama-disable
 
 # Default target
 .DEFAULT_GOAL := help
@@ -103,9 +103,15 @@ typecheck: ## Run TypeScript compiler (no emit)
 check: lint typecheck test-run ## Run all checks (lint, typecheck, test)
 
 # Dependencies
-install: ## Install dependencies
+deps: ## Install dependencies
 	pnpm install
 
+install: ## Install flynn CLI as a shell command (build + global link)
+	pnpm install
+	pnpm build
+	pnpm link --global
+	@echo "flynn installed. If the command is not found, add PNPM_HOME to your PATH."
+
 # Utilities
 help: ## Show this help message
 	@echo "Flynn - Self-hosted personal AI agent"
diff --git a/README.md b/README.md
index fef4d7c..1eea554 100644
--- a/README.md
+++ b/README.md
@@ -38,15 +38,14 @@ Self-hosted personal AI assistant with Telegram and Terminal interfaces.
 ## Quick Start
 
 ```bash
-# Install dependencies
-pnpm install
+# Install flynn CLI command (build + global link)
+make install
 
 # Copy and configure
 cp config/default.yaml ~/.config/flynn/config.yaml
 # Edit config with your API keys and Telegram bot token
 
-# Build and run
-pnpm build
+# Run
 flynn start
 
 # Or run without building