codesesh 0.12.0 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -19,6 +19,8 @@ Your browser will open at `http://localhost:4521` with all your sessions ready t
19
19
  ## Features
20
20
 
21
21
  - **Unified Timeline** — Browse sessions across all your AI agents in a single, searchable interface
22
+ - **Flexible Time Ranges** — Switch between rolling presets, all history, or a custom date range without restarting the server
23
+ - **Session Aliases** — Give important sessions memorable local names that carry through search, bookmarks, and activity views
22
24
  - **Structured Global Search** — Search titles, messages, tool output, and file paths with filters for agent, project, smart tag, tool, file activity, and cost
23
25
  - **Dashboard & Activity Trends** — See totals, daily activity, agent distribution, model usage, token trends, smart tags, bookmarks, and recent sessions
24
26
  - **Project Browse Mode** — Open a dedicated projects view with project-level metrics, sessions, and cross-agent drill-down
@@ -80,6 +82,8 @@ npx codesesh --trace
80
82
  | Flag | Alias | Default | Description |
81
83
  | ----------- | ----- | ------- | ----------------------------------------------------------- |
82
84
  | `--port` | `-p` | `4521` | HTTP server starting port; falls back to the next available port if busy |
85
+ | `--host` | — | `127.0.0.1` | HTTP server bind address; non-loopback values require `--remote-access` |
86
+ | `--remote-access` | — | `false` | Enable token-protected access on a non-loopback host |
83
87
  | `--days` | `-d` | `7` | Only include sessions active in the last N days (`0` = all time) |
84
88
  | `--cwd` | — | — | Filter to sessions from a project directory |
85
89
  | `--agent` | `-a` | all | Filter to specific agent(s), comma-separated |
@@ -93,9 +97,13 @@ npx codesesh --trace
93
97
  | `--clear-cache` | — | `false` | Clear scan cache before starting |
94
98
  | `-v` | — | — | Print version number |
95
99
 
100
+ When remote access is enabled, CodeSesh prints a startup URL containing a fresh access token.
101
+ Anyone with that URL can read the indexed AI session history, so treat it as a password and do not
102
+ share or persist it.
103
+
96
104
  ## Requirements
97
105
 
98
- - Node.js 18+
106
+ - Node.js 22+
99
107
 
100
108
  ## Links
101
109