docs: update documentation for recent changes (#29)

* docs: update documentation for recent changes

- Add --direct flag to README CLI options
- Fix file paths in DEVELOPMENT.md and CLAUDE.md (bin.ts, cli.config.ts now in src/)
- Fix command references (workos, not workos-installer)
- Add new auth files to project structure (credential-proxy, ensure-auth, background-refresh)

* docs: add conventional commit guidelines to CLAUDE.md

Ensures AI assistants use proper commit format for release-please automation.

Author: nicknisi

CLAUDE.md

@@ -7,20 +7,23 @@ AI-powered CLI installer that automatically installs WorkOS AuthKit into web pro
 ```
 installer/
 ├── src/
+│   ├── bin.ts              # CLI entry point
+│   ├── cli.config.ts       # App configuration (model, URLs, etc.)
 │   ├── run.ts              # Entry point, orchestrates installer flow
 │   ├── lib/
 │   │   ├── agent-interface.ts  # Claude Agent SDK integration
 │   │   ├── agent-runner.ts     # Builds prompts, runs agent
 │   │   ├── config.ts           # Framework detection config
-│   │   └── constants.ts        # Integration enum, shared constants
+│   │   ├── constants.ts        # Integration enum, shared constants
+│   │   ├── credential-proxy.ts # Token refresh proxy for long sessions
+│   │   └── ensure-auth.ts      # Startup auth guard with token refresh
 │   ├── dashboard/          # Ink/React TUI components
 │   ├── nextjs/             # Next.js installer agent
 │   ├── react/              # React SPA installer agent
 │   ├── react-router/       # React Router installer agent
 │   ├── tanstack-start/     # TanStack Start installer agent
 │   └── vanilla-js/         # Vanilla JS installer agent
-├── bin.ts                  # CLI entry point
-└── cli.config.ts           # App configuration (model, URLs, etc.)
+└── ...
 ```
 
 ## Key Architecture
@@ -66,6 +69,21 @@ The dashboard code lives in `src/dashboard/` and uses `InstallerEventEmitter` to
 - **Ink + React 19** for TUI dashboard
 - **Never commit the `docs/` directory** - it contains local ideation artifacts
 
+## Commit Conventions
+
+Use [Conventional Commits](https://www.conventionalcommits.org/) - release-please auto-generates changelog from these.
+
+```
+feat: add new feature        → minor version bump, appears in changelog
+fix: correct bug             → patch version bump, appears in changelog
+docs: update readme          → no version bump
+chore: update deps           → no version bump
+refactor: restructure code   → no version bump
+refactor!: breaking change   → major version bump (or minor if pre-1.0)
+```
+
+Breaking changes: add `!` after type (e.g., `feat!:`) or include `BREAKING CHANGE:` in body.
+
 ## Commands
 
 ```bash

DEVELOPMENT.md

@@ -5,6 +5,8 @@
 ```
 installer/
 ├── src/
+│   ├── bin.ts                # CLI entry point
+│   ├── cli.config.ts         # App configuration (model, URLs)
 │   ├── run.ts                # Entry point
 │   ├── lib/
 │   │   ├── agent-runner.ts       # Core agent execution
@@ -14,6 +16,9 @@ installer/
 │   │   ├── framework-config.ts   # Framework definitions
 │   │   ├── constants.ts          # Integration types
 │   │   ├── events.ts             # InstallerEventEmitter
+│   │   ├── credential-proxy.ts   # Token refresh proxy for long sessions
+│   │   ├── ensure-auth.ts        # Startup auth guard
+│   │   ├── background-refresh.ts # Background token refresh
 │   │   └── adapters/             # CLI and dashboard adapters
 │   ├── commands/                 # Subcommands (install-skill, login, logout)
 │   ├── steps/                    # Installer step implementations
@@ -29,8 +34,6 @@ installer/
 │       ├── redact.ts             # Credential redaction
 │       ├── package-manager.ts    # Package manager detection
 │       └── ...                   # Additional utilities
-├── bin.ts                    # CLI entry point
-├── installer.config.ts       # App configuration (model, URLs)
 ├── tsconfig.json             # TypeScript config
 └── package.json              # Dependencies and scripts
 ```
@@ -53,7 +56,7 @@ pnpm dev
 
 # Test locally in another project
 cd /path/to/test/nextjs-app
-workos-installer dashboard
+workos dashboard
 ```
 
 ## Commands
@@ -141,7 +144,7 @@ export function redactCredentials(obj: any): any {
 **Verbose logs:**
 
 ```bash
-workos-installer --debug
+workos --debug
 ```
 
 **Check logs:**

README.md

@@ -57,6 +57,7 @@ Commands:
     --agent, -a          Target agent(s): claude-code, codex, cursor, goose
 
 Options:
+  --direct, -D            Use your own Anthropic API key (bypass llm-gateway)
   --integration <name>    Framework: nextjs, react, react-router, tanstack-start, vanilla-js
   --redirect-uri <uri>    Custom redirect URI (defaults to framework convention)
   --homepage-url <url>    Custom homepage URL (defaults to http://localhost:{port})