Add installation docs, make CLI version dynamic, and update packaging metadata

- Add Installation (end-user & development) section to README and simplify Quick Start/Usage examples (remove uv prefix for end-user commands; note to use `uv run` when developing).
- Make CLI version output dynamic using importlib.metadata with a PackageNotFoundError fallback instead of a hardcoded string.
- Add project metadata (authors, license, keywords, classifiers, URLs) and sdist include list to pyproject.toml for improved packaging.

Author: madebygps

README.md

@@ -5,6 +5,51 @@
 
 AI-powered personal knowledge system with daily planning, reflective journaling, semantic backlinks, and intelligent book notes search.
 
+## Installation
+
+### For End Users
+
+Install directly from GitHub:
+
+```bash
+# Using uv (recommended - fastest)
+uv tool install git+https://github.com/madebygps/second-brain.git
+
+# Or using pipx (isolated environment)
+pipx install git+https://github.com/madebygps/second-brain.git
+
+# Or using pip (system-wide)
+pip install git+https://github.com/madebygps/second-brain.git
+```
+
+After installation, the `brain` command will be available globally:
+```bash
+brain --help
+brain plan create today
+brain diary create today
+```
+
+### For Development
+
+```bash
+# Clone the repository
+git clone https://github.com/madebygps/second-brain.git
+cd second-brain
+
+# Install with uv
+uv sync
+
+# Set up pre-commit hooks
+uv run pre-commit install
+
+# Configure environment
+cp .env.example .env
+# Edit .env with your paths and Azure credentials
+
+# Run in development mode
+uv run brain --help
+```
+
 ## Features
 
 **Planning** (`brain plan`)
@@ -29,60 +74,58 @@ AI-powered personal knowledge system with daily planning, reflective journaling,
 
 ## Quick Start
 
-```bash
-# Install dependencies
-uv sync
+After installing (see [Installation](#installation)):
 
-# Set up pre-commit hooks (optional but recommended)
-uv run pre-commit install
-
-# Configure
+```bash
+# Configure (first time only)
 cp .env.example .env
 # Edit .env with your paths and Azure credentials
 
 # Morning: Create your planning entry (saves to PLANNER_PATH)
-uv run brain plan create today
+brain plan create today
 
 # Evening: Create your reflection entry (saves to DIARY_PATH)
-uv run brain diary create today
+brain diary create today
 
 # Search your book notes
-uv run brain notes search "discipline"
+brain notes search "discipline"
 ```
 
+> **Note:** If developing locally, prefix commands with `uv run` (e.g., `uv run brain plan create today`)
+
 ## Usage
 
 ```bash
 # Planning
-uv run brain plan create today        # Create daily plan with LLM task extraction
-uv run brain plan create tomorrow     # Plan for tomorrow
+brain plan create today        # Create daily plan with LLM task extraction
+brain plan create tomorrow     # Plan for tomorrow
 
 # Diary management
-uv run brain diary create today       # Create reflection entry
-uv run brain diary link today         # Generate semantic backlinks
-uv run brain diary refresh 30         # Bulk refresh past 30 days
-uv run brain diary list 7             # List recent entries
+brain diary create today       # Create reflection entry
+brain diary link today         # Generate semantic backlinks
+brain diary refresh 30         # Bulk refresh past 30 days
+brain diary list 7             # List recent entries
 
 # Analysis
-uv run brain diary report 30          # Memory trace report (activities & connections)
-uv run brain diary patterns 7         # Emotional & psychological patterns
+brain diary report 30          # Memory trace report (activities & connections)
+brain diary patterns 7         # Emotional & psychological patterns
 
 # Notes search
-uv run brain notes search "topic"     # Search book notes
-uv run brain notes search "topic" --semantic --detailed
-uv run brain notes status             # Check connection
+brain notes search "topic"     # Search book notes
+brain notes search "topic" --semantic --detailed
+brain notes status             # Check connection
 
 # Cost tracking and analysis
-uv run brain cost summary             # Usage summary for last 30 days
-uv run brain cost trends 30           # Daily cost trends
-uv run brain cost estimate            # Monthly cost projection
-uv run brain cost breakdown           # Per-operation breakdown
-uv run brain cost export data.json    # Export to JSON
-uv run brain cost pricing             # Show pricing
+brain cost summary             # Usage summary for last 30 days
+brain cost trends 30           # Daily cost trends
+brain cost estimate            # Monthly cost projection
+brain cost breakdown           # Per-operation breakdown
+brain cost export data.json    # Export to JSON
+brain cost pricing             # Show pricing
 
 # Logging (Rich-formatted, colored output)
-uv run brain --verbose <command>      # Show key operations
-uv run brain --debug <command>        # Full diagnostics with LLM details
+brain --verbose <command>      # Show key operations
+brain --debug <command>        # Full diagnostics with LLM details
 ```
 
 > **Clean UX:** By default, logs are suppressed during operations to avoid interrupting spinners. Use `--verbose` or `--debug` for detailed information with beautiful Rich formatting.

brain_cli/main.py

@@ -1,5 +1,7 @@
 """Main CLI entry point for the brain system."""
 
+from importlib.metadata import PackageNotFoundError, version
+
 import typer
 
 from brain_cli.cost_commands import app as cost_app
@@ -16,7 +18,11 @@
 def version_callback(value: bool):
     """Show version information."""
     if value:
-        typer.echo("Brain CLI v1.0.0")
+        try:
+            pkg_version = version("second-brain")
+        except PackageNotFoundError:
+            pkg_version = "0.1.0 (dev)"
+        typer.echo(f"Brain CLI v{pkg_version}")
         raise typer.Exit()
 
 

pyproject.toml

@@ -4,6 +4,20 @@ version = "0.1.0"
 description = "AI-powered journaling with smart prompts and automatic backlinks"
 readme = "README.md"
 requires-python = ">=3.13"
+authors = [
+    { name = "Gwyneth Peña-Siguenza", email = "[email protected]" }
+]
+license = { text = "MIT" }
+keywords = ["journaling", "AI", "productivity", "knowledge-management", "obsidian", "azure-openai"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business",
+    "Topic :: Utilities",
+]
 dependencies = [
     "typer>=0.15.1",
     "rich>=13.9.4",
@@ -13,6 +27,12 @@ dependencies = [
     "openai>=1.57.2",
 ]
 
+[project.urls]
+Homepage = "https://github.com/madebygps/second-brain"
+"Bug Tracker" = "https://github.com/madebygps/second-brain/issues"
+Documentation = "https://github.com/madebygps/second-brain#readme"
+"Source Code" = "https://github.com/madebygps/second-brain"
+
 [project.scripts]
 brain = "brain_cli.main:app"
 
@@ -23,6 +43,18 @@ build-backend = "hatchling.build"
 [tool.hatch.build.targets.wheel]
 packages = ["brain_core", "brain_cli"]
 
+[tool.hatch.build.targets.sdist]
+# Only include essential files in source distribution
+include = [
+    "/brain_core",
+    "/brain_cli",
+    "/tests",
+    "/LICENSE",
+    "/README.md",
+    "/pyproject.toml",
+    "/.env.example",
+]
+
 [tool.uv]
 package = true