chore: update setup with .env.example

Author: damassi

.env.example

@@ -0,0 +1,5 @@
+# Required
+ANTHROPIC_API_KEY=
+
+# Generate at https://github.com/settings/personal-access-tokens
+GITHUB_ACCESS_TOKEN=

Makefile

@@ -1,7 +1,7 @@
 .PHONY: chat dev console
 
 install:
-	uv sync && uv run pre-commit install
+	uv sync && uv run pre-commit install && cp .env.example .env && echo "Please edit the .env file with your API keys."
 
 chat:
 	uv run chat

README.md

@@ -6,27 +6,38 @@ https://github.com/user-attachments/assets/66a1d462-e51a-419f-80f3-fa69ee60db9c
 
 ## Purpose
 
-This tool is for those who wish for slightly more control over their MCP servers via configurable system prompts, and a minimal terminal-based MCP form factor. (It can do a lot of things thanks to the Claude Agent SDK, but the main purpose, at least for me, is a simple, humble and performant MCP interface to whatever tools I typically use day-to-day.)
+This tool is for those who want slightly more control over their MCP servers via configurable system prompts, and a minimal terminal-based MCP form factor for interaction. Many more things are possible thanks to the Claude Agent SDK, but the main purpose, at least for me, is a simple, humble and performant MCP interface to whatever tools I typically use day-to-day.
 
-> Note: The Python version is visually sturdier than the Node.js version. No more crazy terminal flashing like in claude-code!
+> Note: The Python version is visually sturdier than the Node.js version. No more crazy terminal flashing like in Claude Code!
 
 ## Setup
 
 This app uses [uv](https://github.com/astral-sh/uv) for package management so first install that. Then:
 
-- `git clone https://github.com/damassi/agent-chat-cli-python.git`
-- `make install`
-- `make chat`
+```bash
+git clone https://github.com/damassi/agent-chat-cli-python.git
+make install
+```
+
+Update the `.env` with your `ANTHROPIC_API_KEY` and then run:
+
+```bash
+make chat
+
+# Alternatively, if in dev (see below)
+make dev
+```
 
 Additional MCP servers are configured in `agent-chat-cli.config.yaml` and prompts added within the `prompts` folder.
 
 ## Development
 
-- Install pre-commit hooks
+- Install pre-commit hooks via [pre-commit](https://pre-commit.com/)
   - `uv run pre-commit install`
 - Typechecking is via [MyPy](https://github.com/python/mypy):
   - `uv run mypy src`
 - Linting and formatting is via [Ruff](https://docs.astral.sh/ruff/)
+  - `uv run ruff check src`
 
 Textual has an integrated logging console which one can boot separately from the app to receive logs.
 
@@ -38,7 +49,7 @@ make console
 
 > Note: this command intentionally filters out more verbose notifications. See the Makefile to configure.
 
-And then in a second, start the textual dev server:
+And then, in a second terminal pane, start the textual dev server:
 
 ```bash
 make dev