@albireo3754/agentlog 0.1.1 → 0.1.2

package/README.md

@@ -1,14 +1,18 @@
 # AgentLog
 
-Claude Code prompts → Obsidian Daily Note, automatically.
+Auto-log Claude Code prompts to Obsidian Daily Notes.
 
-Every time you type a prompt in Claude Code, AgentLog captures it and appends it to your Obsidian Daily Note — with timestamps, grouped by project and session.
+AgentLog is a local-first Claude Code prompt logger for Obsidian. It captures every prompt you type in Claude Code and appends it to today's Daily Note, grouped by project and session.
 
-```
-npx agentlog init ~/Obsidian
+Use it as a lightweight developer journal, worklog capture layer, or the first building block for richer Daily Notes automation.
+
+```bash
+# Requires Bun (https://bun.sh) installed and available on your PATH
+npm install -g @albireo3754/agentlog
+agentlog init ~/Obsidian
 ```
 
-That's it. Start using Claude Code and your Daily Note fills itself.
+Install it once, start using Claude Code, and your Daily Note fills itself.
 
 ## What It Does
 
@@ -16,28 +20,35 @@ That's it. Start using Claude Code and your Daily Note fills itself.
 Claude Code prompt → UserPromptSubmit hook → Daily Note append
 ```
 
+## Why AgentLog
+
+- Local-first prompt logging with no external service required
+- Obsidian Daily Notes integration that works with your existing vault
+- Project and session grouping so prompts stay readable later
+- Zero copy-paste overhead during normal Claude Code use
+
 **Before:** You finish a 3-hour Claude Code session. Your Daily Note is empty.
 
 **After:**
 
 ```markdown
 ## AgentLog
-> 🕐 11:21 — js/agentlog › git init하고 vscode로 열어봐
+> 🕐 11:21 — js/agentlog › initialize git and open it in VS Code
 
 #### 10:53 · js/agentlog
 <!-- cwd=/Users/you/work/js/agentlog -->
 - - - - [[ses_a1b2c3d4]]
-- 10:53 agentlog 개발을 위해서 작업 진행
-- 11:07 스펙 문서 열어봐
+- 10:53 start building agentlog
+- 11:07 open the spec document
 - - - - [[ses_e5f6a7b8]]
-- 11:21 git init하고 vscode로 열어봐
+- 11:21 initialize git and open it in VS Code
 ```
 
 | Element | Role |
 |---------|------|
 | `> 🕐 HH:MM — project › prompt` | Latest entry (always updated) |
 | `#### HH:MM · project` | Project subsection (grouped by cwd) |
-| `<!-- cwd=... -->` | Section matching key (Reading view에서 숨김) |
+| `<!-- cwd=... -->` | Section matching key (hidden in Obsidian Reading view) |
 | `- - - - [[ses_...]]` | Session boundary (Obsidian wiki-link) |
 | `- HH:MM prompt` | Individual log entry |
 
@@ -47,12 +58,17 @@ No manual logging. No copy-paste. No AI summarization overhead.
 
 ```bash
 # With Bun
-bunx agentlog init ~/path/to/vault
+bun add -g @albireo3754/agentlog
 
 # With npm
-npx agentlog init ~/path/to/vault
+npm install -g @albireo3754/agentlog
+
+# Then configure your vault
+agentlog init ~/path/to/vault
 ```
 
+AgentLog registers the Claude Code hook as `agentlog hook`, so the `agentlog` binary must remain available on your `PATH` after setup.
+
 ### Requirements
 
 - [Claude Code](https://claude.ai/code) (hook integration)
@@ -86,7 +102,7 @@ Use Claude Code normally. Every prompt you type gets logged to your Daily Note.
 1. You type a prompt in Claude Code
 2. Claude Code fires the `UserPromptSubmit` hook
 3. AgentLog reads the prompt from stdin and sanitizes it
-4. Finds your Daily Note via `obsidian daily:path` (Obsidian CLI 1.12+), fallback: `{vault}/Daily/YYYY-MM-DD-요일.md`
+4. Finds your Daily Note via `obsidian daily:path` (Obsidian CLI 1.12+). If that fails, it falls back to `{vault}/Daily/YYYY-MM-DD-<Korean weekday>.md`
 5. Finds or creates a `## AgentLog` section
 6. Finds or creates a `#### project` subsection matching the current working directory
 7. Inserts a session divider `[[ses_...]]` if the session changed, then appends the entry
@@ -98,25 +114,25 @@ Total overhead: < 50ms per prompt. Fire-and-forget, never blocks Claude Code.
 
 ### Obsidian Mode (default)
 
-Daily Note 경로는 `obsidian daily:path` CLI 명령으로 동적 해석 (Obsidian 1.12+). Obsidian이 실행 중이 아니거나 CLI를 사용할 수 없으면 `{vault}/Daily/YYYY-MM-DD-요일.md`로 fallback.
+AgentLog resolves the Daily Note path via `obsidian daily:path` when the Obsidian CLI is available (1.12+). If the CLI is unavailable or Obsidian is not running, it falls back to `{vault}/Daily/YYYY-MM-DD-<Korean weekday>.md` such as `2026-03-01-일.md`.
 
 Each working directory gets its own `#### project` subsection. Session changes insert a `[[ses_...]]` wiki-link divider. The `> 🕐` blockquote at the top always shows the latest entry across all projects.
 
 ```markdown
 ## AgentLog
-> 🕐 14:30 — kotlin/message-gate › API 응답 수정
+> 🕐 14:30 — kotlin/message-gate › adjust the API response
 
 #### 10:53 · js/agentlog
 <!-- cwd=/Users/you/work/js/agentlog -->
 - - - - [[ses_a1b2c3d4]]
-- 10:53 agentlog 개발을 위해서 작업 진행
-- 11:07 스펙 문서 열어봐
+- 10:53 start building agentlog
+- 11:07 open the spec document
 
 #### 14:00 · kotlin/message-gate
 <!-- cwd=/Users/you/work/kotlin/message-gate -->
 - - - - [[ses_e5f6a7b8]]
-- 14:00 API 응답 수정
-- 14:30 테스트 실행
+- 14:00 adjust the API response
+- 14:30 run tests
 ```
 
 ### Plain Mode
@@ -125,19 +141,20 @@ With `--plain`, entries go to `{folder}/YYYY-MM-DD.md`:
 
 ```markdown
 # 2026-03-02
-- 10:53 agentlog 개발을 위해서 작업 진행
+- 10:53 start building agentlog
 ```
 
 ## CLI Reference
 
 | Command | Description |
 |---------|-------------|
-| `agentlog init [vault] [--plain]` | Vault 경로 설정 + Claude Code hook 등록. 인자 없으면 자동 감지 |
-| `agentlog detect` | 설치된 Obsidian vault 목록 + CLI 상태 표시 |
-| `agentlog doctor` | 설치 상태 헬스체크 (binary, vault, hook, Obsidian CLI 등) |
-| `agentlog open` | 오늘의 Daily Note를 Obsidian에서 열기 (CLI 1.12+ 필요) |
-| `agentlog uninstall [-y]` | Hook 제거 + `~/.agentlog/` 삭제. `-y`로 확인 생략 |
-| `agentlog hook` | Claude Code가 자동 호출 (사용자 직접 실행 X) |
+| `agentlog init [vault] [--plain]` | Configure the vault path and register the Claude Code hook. Auto-detect vaults when the path is omitted |
+| `agentlog detect` | List detected Obsidian vaults and CLI status |
+| `agentlog doctor` | Run health checks for the binary, vault, hook, and Obsidian CLI |
+| `agentlog open` | Open today's Daily Note in Obsidian (requires CLI 1.12+) |
+| `agentlog version` | Print AgentLog version. In `dev` builds, also shows channel and commit |
+| `agentlog uninstall [-y]` | Remove the hook and delete `~/.agentlog/`. Use `-y` to skip confirmation |
+| `agentlog hook` | Invoked automatically by Claude Code (not for direct use) |
 
 ## Configuration
 
@@ -145,15 +162,34 @@ With `--plain`, entries go to `{folder}/YYYY-MM-DD.md`:
 
 | Field | Default | Description |
 |-------|---------|-------------|
-| `vault` | (required) | Obsidian vault 또는 plain 폴더 경로 |
-| `plain` | `false` | Plain 모드 (Obsidian 없이 단순 파일 기록) |
+| `vault` | (required) | Path to the Obsidian vault or plain output folder |
+| `plain` | `false` | Plain mode that writes simple markdown files without Obsidian integration |
 
-환경변수:
+Environment variables:
 
 | Variable | Description |
 |----------|-------------|
-| `AGENTLOG_CONFIG_DIR` | Config 디렉토리 오버라이드 (기본: `~/.agentlog`) |
-| `OBSIDIAN_BIN` | Obsidian CLI 바이너리 경로 오버라이드 |
+| `AGENTLOG_CONFIG_DIR` | Override the config directory (default: `~/.agentlog`) |
+| `AGENTLOG_PHASE` | Force the runtime channel (`dev` or `prod`), overriding auto-detection |
+| `OBSIDIAN_BIN` | Override the Obsidian CLI binary path |
+
+`agentlog version`은 현재 실행 중인 AgentLog의 build identity를 출력합니다.
+
+- `prod`: 헤드라인만 출력
+
+```text
+AgentLog 0.1.1
+```
+
+- `dev`: 개발 실행임을 나타내는 메타데이터를 추가 출력
+
+```text
+AgentLog 0.1.1
+channel: dev
+commit: <short-sha>
+```
+
+기본 규칙은 git 메타데이터가 있는 checkout/link 실행이면 `dev`, 패키지 설치본이면 `prod`입니다. 테스트나 디버깅에서 channel을 고정하고 싶다면 `AGENTLOG_PHASE=dev` 또는 `AGENTLOG_PHASE=prod`를 사용할 수 있습니다.
 
 ## Uninstall
 
@@ -161,27 +197,27 @@ With `--plain`, entries go to `{folder}/YYYY-MM-DD.md`:
 agentlog uninstall
 ```
 
-Hook을 `~/.claude/settings.json`에서 제거하고 `~/.agentlog/`를 삭제합니다.
+This removes the hook from `~/.claude/settings.json` and deletes `~/.agentlog/`.
 
 ## Development
 
 ```bash
 bun install
-bun test              # 120 pass / 120 tests
-bun run typecheck     # tsc --noEmit
+bun test              # run the test suite
+bun run typecheck     # run tsc --noEmit
 bun run build         # compile to dist/ (optional)
 ```
 
-`bin`이 `src/cli.ts`를 직접 가리키므로 개발 중 빌드 불필요 — Bun이 TypeScript를 네이티브 실행합니다.
+The `bin` entry points directly to `src/cli.ts`, so you do not need a build during development. Bun runs TypeScript natively.
 
 ```bash
-# 글로벌 커맨드로 링크
+# Link as a global command
 bun link
 
-# 소스 수정 → 즉시 반영
+# Edit source and run immediately
 agentlog doctor
 
-# Watch 모드
+# Watch mode
 bun run dev:watch
 ```
 

package/package.json

@@ -1,11 +1,28 @@
 {
   "name": "@albireo3754/agentlog",
-  "version": "0.1.1",
-  "description": "Claude Code prompts → Obsidian Daily Note auto-logger",
+  "version": "0.1.2",
+  "description": "Auto-log Claude Code prompts to Obsidian Daily Notes",
   "type": "module",
   "bin": {
     "agentlog": "./src/cli.ts"
   },
+  "keywords": [
+    "claude-code",
+    "obsidian",
+    "daily-notes",
+    "prompt-logging",
+    "developer-journal",
+    "worklog",
+    "hook"
+  ],
+  "homepage": "https://github.com/albireo3754/agentlog#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/albireo3754/agentlog.git"
+  },
+  "bugs": {
+    "url": "https://github.com/albireo3754/agentlog/issues"
+  },
   "scripts": {
     "build": "bun build src/cli.ts src/hook.ts --outdir dist --target node",
     "dev": "bun run src/cli.ts",

package/src/cli.ts

@@ -8,7 +8,7 @@
  *   agentlog hook                     — invoked by Claude Code UserPromptSubmit hook
  */
 
-import { existsSync, readFileSync, rmSync } from "fs";
+import { existsSync, rmSync } from "fs";
 import { join, resolve } from "path";
 import { homedir } from "os";
 import { spawnSync } from "child_process";
@@ -16,6 +16,7 @@ import { saveConfig, loadConfig, expandHome, configPath, configDir } from "./con
 import { detectVaults, detectCli } from "./detect.js";
 import { isVersionAtLeast, MIN_CLI_VERSION, resolveCliBin, parseCliVersion } from "./obsidian-cli.js";
 import { registerHook, unregisterHook, isHookRegistered, CLAUDE_SETTINGS_PATH } from "./claude-settings.js";
+import { formatVersionHeadline, formatVersionOutput, getRuntimeInfo, readVersion, resolvePackageRoot } from "./version-info.js";
 import * as readline from "readline";
 
 function usage(): void {
@@ -25,6 +26,7 @@ function usage(): void {
   agentlog doctor                   Check installation health
   agentlog open                     Open today's Daily Note in Obsidian (CLI)
   agentlog uninstall                Remove hook and config
+  agentlog version                  Print version and build identity
   agentlog hook                     Run hook (called by Claude Code)
 
 Options:
@@ -55,10 +57,10 @@ Warning: Obsidian vault not detected at: ${vault}
 
 1. Install Obsidian: https://obsidian.md/download
 2. Open the folder as a vault, then run:
-   npx agentlog init /path/to/your/vault
+   agentlog init /path/to/your/vault
 
 Or to write to a plain folder:
-   npx agentlog init --plain ~/notes
+   agentlog init --plain ~/notes
 `);
       process.exit(1);
     }
@@ -238,14 +240,8 @@ async function cmdUninstall(args: string[]): Promise<void> {
 
 /** agentlog doctor — check installation health */
 async function cmdDoctor(): Promise<void> {
-  // Show agentlog version
-  try {
-    const pkgPath = join(import.meta.dir ?? new URL(".", import.meta.url).pathname, "..", "package.json");
-    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8")) as { version?: string };
-    if (pkg.version) console.log(`agentlog v${pkg.version}\n`);
-  } catch {
-    // version display is best-effort
-  }
+  const version = readVersion(resolvePackageRoot());
+  if (version) console.log(`${formatVersionHeadline({ version })}\n`);
 
   let allOk = true;
 
@@ -259,7 +255,12 @@ async function cmdDoctor(): Promise<void> {
   // 1. Binary in PATH
   const which = spawnSync("which", ["agentlog"], { encoding: "utf-8" });
   const binPath = which.status === 0 ? which.stdout.trim() : "";
-  check("binary", !!binPath, binPath || "not found in PATH", "run: npm install -g agentlog");
+  check(
+    "binary",
+    !!binPath,
+    binPath || "not found in PATH",
+    "install agentlog globally (e.g. npm install -g @albireo3754/agentlog or bun install -g @albireo3754/agentlog)"
+  );
 
   // 2. Vault (covers both config presence and vault validity)
   const config = loadConfig();
@@ -390,6 +391,10 @@ async function cmdHook(): Promise<void> {
   await import("./hook.js");
 }
 
+async function cmdVersion(): Promise<void> {
+  console.log(formatVersionOutput(getRuntimeInfo()));
+}
+
 // --- Main dispatch ---
 
 const [, , command, ...rest] = process.argv;
@@ -410,6 +415,9 @@ switch (command) {
   case "uninstall":
     await cmdUninstall(rest);
     break;
+  case "version":
+    await cmdVersion();
+    break;
   case "hook":
     await cmdHook();
     break;

package/src/version-info.ts

@@ -0,0 +1,106 @@
+import { existsSync, readFileSync } from "fs";
+import { spawnSync } from "child_process";
+import { dirname, join, resolve } from "path";
+import { fileURLToPath } from "url";
+
+export type AgentlogChannel = "dev" | "prod";
+
+export type RuntimeInfo = {
+  version: string | null;
+  channel: AgentlogChannel;
+  commit: string | null;
+  packageRoot: string;
+};
+
+type RuntimeInfoOptions = {
+  env?: Record<string, string | undefined>;
+  packageRoot?: string;
+  moduleDir?: string;
+};
+
+function currentModuleDir(): string {
+  return typeof import.meta.dir === "string"
+    ? import.meta.dir
+    : dirname(fileURLToPath(import.meta.url));
+}
+
+export function resolvePackageRoot(moduleDir: string = currentModuleDir()): string {
+  return resolve(moduleDir, "..");
+}
+
+function hasGitMetadata(startDir: string): boolean {
+  let currentDir = startDir;
+
+  while (true) {
+    if (existsSync(join(currentDir, ".git"))) return true;
+
+    const parentDir = dirname(currentDir);
+    if (parentDir === currentDir) return false;
+    currentDir = parentDir;
+  }
+}
+
+export function readVersion(packageRoot: string): string | null {
+  try {
+    const pkg = JSON.parse(readFileSync(join(packageRoot, "package.json"), "utf-8")) as {
+      version?: string;
+    };
+    return typeof pkg.version === "string" ? pkg.version : null;
+  } catch {
+    return null;
+  }
+}
+
+export function detectPhase({
+  env = process.env,
+  packageRoot = resolvePackageRoot(),
+}: RuntimeInfoOptions = {}): AgentlogChannel {
+  const override = env.AGENTLOG_PHASE?.trim().toLowerCase();
+  if (override === "dev" || override === "prod") return override;
+  return hasGitMetadata(packageRoot) ? "dev" : "prod";
+}
+
+function readCommit(packageRoot: string, channel: AgentlogChannel): string | null {
+  if (channel !== "dev") return null;
+
+  const git = spawnSync("git", ["rev-parse", "--short", "HEAD"], {
+    cwd: packageRoot,
+    encoding: "utf-8",
+    timeout: 3000,
+  });
+
+  if (git.status !== 0) return null;
+  const commit = git.stdout.trim();
+  return commit.length > 0 ? commit : null;
+}
+
+export function getRuntimeInfo(options: RuntimeInfoOptions = {}): RuntimeInfo {
+  const env = options.env ?? process.env;
+  const packageRoot = options.packageRoot ?? resolvePackageRoot(options.moduleDir);
+  const gitBacked = hasGitMetadata(packageRoot);
+  const override = env.AGENTLOG_PHASE?.trim().toLowerCase();
+  const channel: AgentlogChannel =
+    override === "dev" || override === "prod" ? override : gitBacked ? "dev" : "prod";
+
+  return {
+    version: readVersion(packageRoot),
+    channel,
+    commit: channel === "dev" && gitBacked ? readCommit(packageRoot, channel) : null,
+    packageRoot,
+  };
+}
+
+export function formatVersionHeadline(info: Pick<RuntimeInfo, "version">): string {
+  return `AgentLog ${info.version ?? "unknown"}`;
+}
+
+export function formatVersionOutput(info: RuntimeInfo): string {
+  const lines = [formatVersionHeadline(info)];
+
+  if (info.channel === "dev") {
+    lines.push("channel: dev");
+    if (info.commit) lines.push(`commit: ${info.commit}`);
+  }
+
+  return lines.join("\n");
+}