Obsidian Stats logoObsidian Stats

Codex Session Archive

by river
5
4
3
2
1
New Plugin
Install Code

Description

Export local Codex archived sessions to Markdown notes grouped by workspace. - This plugin has not been manually reviewed by Obsidian staff.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Codex Session Archive

Codex Session Archive exports local Codex session JSONL files into Markdown notes inside your Obsidian vault.

It is built for Codex Desktop / Codex CLI local logs:

  • ~/.codex/archived_sessions/rollout-*.jsonl
  • optionally ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl
  • ~/.codex/session_index.jsonl for thread titles and update times

Features

  • Exports archived Codex sessions to Markdown.
  • Groups notes by the session workdir/project name.
  • Adds Obsidian frontmatter with session id, project, cwd, source JSONL path, and tags.
  • Extracts data:image/...;base64,... images into a media/ folder next to the Markdown file.
  • Writes image links as ![image](<media/file name.png>) so Obsidian handles spaces in paths.
  • Skips already-exported sessions by codex_session_id unless overwrite is enabled.

Commands

  • Codex Session Archive: Export archived sessions
  • Codex Session Archive: Rebuild archived sessions

Settings

  • Codex home: defaults to ~/.codex.
  • Output folder: defaults to Archive/Codex Sessions and is relative to the current vault.
  • Include active sessions: also scan ~/.codex/sessions.
  • Overwrite existing exports: rewrite previously exported notes.
  • Include tool details: include full tool call arguments and outputs.
  • Include system messages: include system/developer/environment messages.
  • Classic role headings: export with explicit role headings instead of the copy-as-Markdown style.

Desktop only

This plugin is desktop-only because it reads files outside the vault from the local Codex data directory.

Filesystem access

The plugin uses Node.js filesystem access to read Codex logs from the configured Codex home directory. Output paths are constrained to the current vault.

Manual install

  1. Build the plugin:

    npm install
npm run build

  2. Copy manifest.json, main.js, and styles.css into:

    <your-vault>/.obsidian/plugins/codex-session-archive/

  3. Reload Obsidian and enable the plugin.

Sponsors