journal

package
v0.8.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 24, 2026 License: Apache-2.0 Imports: 5 Imported by: 0

Documentation

Overview

Package journal implements the "ctx journal" command for analyzing and publishing exported AI session files.

The journal system provides two output formats from .context/journal/ entries:

  • ctx journal site: generates a zensical-compatible static site with browsable session history, topic/file/type indices, and search.
  • ctx journal obsidian: generates an Obsidian vault with wikilinks, MOC (Map of Content) pages, and graph-optimized cross-linking.

Both formats reuse the same scan/parse/index infrastructure and consume the same enriched journal entries (YAML frontmatter with topics, type, outcome, technologies, key_files).

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Cmd

func Cmd() *cobra.Command

Cmd returns the journal command with subcommands.

The journal system provides LLM-powered analysis and synthesis of exported session files in .context/journal/.

Returns:

  • *cobra.Command: The journal command with subcommands

Types

This section is empty.

Directories

Path Synopsis
cmd
obsidian
Package obsidian implements the ctx journal obsidian subcommand.
Package obsidian implements the ctx journal obsidian subcommand.
site
Package site provides the journal site subcommand for generating a static site from journal entries.
Package site provides the journal site subcommand for generating a static site from journal entries.
core
collapse
Package collapse wraps long tool output turns in collapsible HTML details blocks.
Package collapse wraps long tool output turns in collapsible HTML details blocks.
consolidate
Package consolidate collapses consecutive identical tool turns into a single turn with a count.
Package consolidate collapses consecutive identical tool turns into a single turn with a count.
format
Package format renders file sizes and other journal metadata in human-readable form.
Package format renders file sizes and other journal metadata in human-readable form.
frontmatter
Package frontmatter transforms journal YAML frontmatter into Obsidian-compatible format.
Package frontmatter transforms journal YAML frontmatter into Obsidian-compatible format.
generate
Package generate builds site index pages, READMEs, and navigation for journal static sites.
Package generate builds site index pages, READMEs, and navigation for journal static sites.
group
Package group organizes journal entries by month for chronological display.
Package group organizes journal entries by month for chronological display.
moc
Package moc generates Obsidian Maps of Content for journal vault navigation.
Package moc generates Obsidian Maps of Content for journal vault navigation.
normalize
Package normalize sanitizes journal Markdown for static site rendering by fixing fences, headings, and list formatting.
Package normalize sanitizes journal Markdown for static site rendering by fixing fences, headings, and list formatting.
parse
Package parse scans journal directories and extracts entry metadata from Markdown files.
Package parse scans journal directories and extracts entry metadata from Markdown files.
reduce
Package reduce strips code fence markers from journal content to eliminate nesting conflicts.
Package reduce strips code fence markers from journal content to eliminate nesting conflicts.
section
Package section builds topic indexes and section pages for journal site navigation.
Package section builds topic indexes and section pages for journal site navigation.
session
Package session counts unique sessions across topic data.
Package session counts unique sessions across topic data.
turn
Package turn extracts and merges conversation turn bodies from journal entries.
Package turn extracts and merges conversation turn bodies from journal entries.
wikilink
Package wikilink converts standard Markdown links to Obsidian wikilink format.
Package wikilink converts standard Markdown links to Obsidian wikilink format.
wrap
Package wrap soft-wraps long lines in journal files to approximately 80 characters.
Package wrap soft-wraps long lines in journal files to approximately 80 characters.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL