codesesh 0.1.5 → 0.3.0

package/README.md

@@ -19,10 +19,14 @@ Your browser will open at `http://localhost:4321` with all your sessions ready t
 ## Features
 
 - **Unified Timeline** — Browse sessions across all your AI agents in a single, searchable interface
+- **Full-Text Search** — Search across session titles and conversation content with highlighted matches
+- **Dashboard & Activity Trends** — See totals, daily activity, agent distribution, and recent sessions
 - **Full Conversation Replay** — Read every message, tool call, and reasoning step exactly as it happened
 - **Cost & Token Visibility** — See exactly how many tokens and dollars each session consumed
+- **SQLite-Backed Cache & Search Index** — Restore session lists quickly and reuse the same local store for search
 - **Zero Configuration** — Just run it. CodeSesh auto-discovers everything on your filesystem
 - **100% Local & Private** — Nothing leaves your machine. No accounts, no cloud sync, no telemetry
+- **Live Refresh** — Local session changes are picked up automatically while the server is running
 
 ## Supported Agents
 
@@ -43,9 +47,12 @@ npx codesesh
 # Choose a custom port
 npx codesesh --port 8080
 
-# Only show sessions from the last 3 days
+# Only show sessions active in the last 3 days
 npx codesesh --days 3
 
+# Jump directly to a session
+npx codesesh --session claudecode://3b0e4ead-eba9-43e7-9fac-b30647e189f8
+
 # Filter to sessions from current project
 npx codesesh --cwd .
 
@@ -54,6 +61,9 @@ npx codesesh --agent claudecode
 
 # Output JSON instead of starting server
 npx codesesh --json
+
+# Show performance trace logs
+npx codesesh --trace
 ```
 
 ## CLI Options
@@ -61,13 +71,17 @@ npx codesesh --json
 | Flag        | Alias | Default | Description                                                 |
 | ----------- | ----- | ------- | ----------------------------------------------------------- |
 | `--port`    | `-p`  | `4321`  | HTTP server port                                            |
-| `--days`    | `-d`  | `7`     | Only include sessions from the last N days (`0` = all time) |
+| `--days`    | `-d`  | `7`     | Only include sessions active in the last N days (`0` = all time) |
 | `--cwd`     | —     | —       | Filter to sessions from a project directory                 |
 | `--agent`   | `-a`  | all     | Filter to specific agent(s), comma-separated                |
-| `--from`    | —     | —       | Sessions created after this date `YYYY-MM-DD`               |
-| `--to`      | —     | —       | Sessions created before this date `YYYY-MM-DD`              |
+| `--from`    | —     | —       | Sessions active after this date `YYYY-MM-DD`                |
+| `--to`      | —     | —       | Sessions active before this date `YYYY-MM-DD`               |
+| `--session` | `-s`  | —       | Directly open a session (`agent://session-id`)              |
 | `--json`    | `-j`  | `false` | Output JSON and exit (no server)                            |
 | `--no-open` | —     | `false` | Don't auto-open the browser                                 |
+| `--trace`   | —     | `false` | Print performance trace logs                                |
+| `--cache`   | —     | `true`  | Use cached scan results when available                      |
+| `--clear-cache` | — | `false` | Clear scan cache before starting                            |
 
 ## Requirements