Fix session tokens --project filter for absolute paths

The filter compared Claude's on-disk project slug
(e.g. "-workspaces-projects-CodeForge") to the raw --project path
(e.g. "/workspaces/projects/CodeForge"), which never matched — so
passing an absolute path per the session-search convention returned
zero sessions.

Encode absolute and ./..-relative inputs to slug form (replace / and
. with -) before comparing. Plain substrings without separators still
pass through unchanged, so --project CodeForge keeps working.

Bump CLI to 0.2.1 and add tokens.test.ts covering the transform.

Author: AnExiledDev

cli/CHANGELOG.md

@@ -1,5 +1,11 @@
 # CodeForge CLI Changelog
 
+## v0.2.1 — 2026-04-16
+
+### Fixes
+
+- **`session tokens --project` now works with absolute paths** — the filter was comparing an on-disk slug (e.g. `-workspaces-projects-CodeForge`) to the raw `--project` path (e.g. `/workspaces/projects/CodeForge`), which never matched. Absolute paths and paths starting with `./` / `../` are now encoded to Claude's slug form (replacing `/` and `.` with `-`) before matching. Plain substrings without separators still pass through unchanged, so `--project CodeForge` keeps working.
+
 ## v0.2.0 — 2026-04-16
 
 ### New Command

cli/package.json

@@ -3,7 +3,7 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"version": "0.2.0",
+	"version": "0.2.1",
 	"description": "CLI for CodeForge development workflows",
 	"keywords": [
 		"codeforge",

cli/src/commands/session/tokens.ts

@@ -1,6 +1,6 @@
 import chalk from "chalk";
 import type { Command } from "commander";
-import { basename } from "path";
+import { basename, isAbsolute, resolve } from "path";
 import { readLines } from "../../search/engine.js";
 import { discoverSessionFiles } from "../../utils/glob.js";
 import { parseRelativeTime, parseTime } from "../../utils/time.js";
@@ -80,6 +80,30 @@ function extractProjectFromPath(filePath: string): string | undefined {
 	return undefined;
 }
 
+/**
+ * Normalize a user-provided --project value for matching against Claude's
+ * on-disk project slugs.
+ *
+ * Claude encodes project cwds by replacing `/` and `.` with `-`, e.g.
+ *   /workspaces/projects/CodeForge  -> -workspaces-projects-CodeForge
+ *   /workspaces/.devcontainer       -> -workspaces--devcontainer
+ *
+ * Behavior:
+ * - Absolute paths are converted to slug form.
+ * - Relative paths beginning with `./` or `../` are resolved against cwd first.
+ * - Plain substrings without separators pass through unchanged so users can
+ *   filter with `--project CodeForge` against the slug (backwards-compatible).
+ */
+export function pathToProjectSlug(input: string): string {
+	const looksLikePath =
+		isAbsolute(input) || input.startsWith("./") || input.startsWith("../");
+	if (looksLikePath) {
+		const abs = isAbsolute(input) ? input : resolve(input);
+		return abs.replace(/\/+$/, "").replace(/[./]/g, "-");
+	}
+	return input;
+}
+
 function isSubagentPath(filePath: string): boolean {
 	return filePath.includes("/subagents/");
 }
@@ -304,11 +328,15 @@ async function analyzeTokens(options: {
 	const mainSessions: SessionTokenStats[] = [];
 	const subagentSessions: SessionTokenStats[] = [];
 
+	const projectNeedle = options.project
+		? pathToProjectSlug(options.project)
+		: undefined;
+
 	for (const filePath of files) {
-		// Filter by project
-		if (options.project) {
+		// Filter by project (slug-to-slug match; absolute paths are encoded).
+		if (projectNeedle) {
 			const project = extractProjectFromPath(filePath);
-			if (!project?.includes(options.project)) continue;
+			if (!project?.includes(projectNeedle)) continue;
 		}
 
 		const stats = await analyzeSessionTokens(filePath);

cli/tests/tokens.test.ts

@@ -0,0 +1,43 @@
+import { describe, expect, test } from "bun:test";
+import { pathToProjectSlug } from "../src/commands/session/tokens.js";
+
+describe("pathToProjectSlug", () => {
+	test("encodes absolute paths to claude's slug form", () => {
+		expect(pathToProjectSlug("/workspaces/projects/CodeForge")).toBe(
+			"-workspaces-projects-CodeForge",
+		);
+	});
+
+	test("encodes dotfiles with double dashes like claude does", () => {
+		// /workspaces/.devcontainer -> /workspaces/-devcontainer (slash -> dash,
+		// then the leading dot on the next segment becomes another dash)
+		expect(pathToProjectSlug("/workspaces/.devcontainer")).toBe(
+			"-workspaces--devcontainer",
+		);
+	});
+
+	test("strips trailing slashes before encoding", () => {
+		expect(pathToProjectSlug("/workspaces/projects/CodeForge/")).toBe(
+			"-workspaces-projects-CodeForge",
+		);
+		expect(pathToProjectSlug("/workspaces/projects/CodeForge///")).toBe(
+			"-workspaces-projects-CodeForge",
+		);
+	});
+
+	test("passes plain substrings through unchanged for backwards compat", () => {
+		// No separator -> user wants substring match against a slug
+		expect(pathToProjectSlug("CodeForge")).toBe("CodeForge");
+		expect(pathToProjectSlug("projects-CodeForge")).toBe("projects-CodeForge");
+	});
+
+	test("resolves relative ./ and ../ paths before encoding", () => {
+		const abs = pathToProjectSlug("./foo");
+		// Resolved path always ends with /foo; after encoding trailing segment is -foo
+		expect(abs.endsWith("-foo")).toBe(true);
+		expect(abs.startsWith("-")).toBe(true);
+
+		const abs2 = pathToProjectSlug("../bar");
+		expect(abs2.endsWith("-bar")).toBe(true);
+	});
+});