coglog-cli 0.9.1

CogLog CLI — a meta-cognition log for LLMs
coglog-cli-0.9.1 is not a library.

coglog-cli v0.9.1 (Rust CLI)

CogLog の CLI。直前ターンのコグログを read / write / clear する。

The CogLog CLI. Reads, writes, and clears the previous turn's coglog.

このクレートについて / About This Crate

coglog-cli は crates.io の coglog と同一の CLI 機能を、npm / Go / PyPI と揃えた名前で提供するクレートです。

coglog-cli provides the same CLI functionality as coglog on crates.io, under a name aligned with npm / Go / PyPI.

バイナリ名について / On the binary name: v0.9.1 時点では、workspace 内の既存 coglog クレート(bin: coglog-cli)との衝突を避けるため、coglog-cli クレートのバイナリは coglog-command という暫定名を使用しています。v0.9.2 で既存 coglog クレートが viewer に転生する際、このクレートのバイナリ名は coglog-cli に統一される予定です。

In v0.9.1, to avoid conflicts with the existing coglog crate (bin: coglog-cli) within the workspace, this coglog-cli crate uses coglog-command as its provisional binary name. This will be unified to coglog-cli in v0.9.2 when the existing coglog crate transitions to a viewer.

インストール / Installation

cargo install coglog-cli

使い方 / Usage

coglog-command read
echo '{"user":"...","thinking":"...","assistant":"...","current_focus":"...","theory_of_mind":"...","self_narrative":"...","annotation":"..."}' | coglog-command write
coglog-command clear

環境変数 / Environment Variables

変数 / Variable 説明 / Description デフォルト / Default
COGLOG_DIR データディレクトリ / Data directory ~/.coglog

--coglog-dir <path> 引数でも指定可能(環境変数より優先)。

Can also be specified via the --coglog-dir <path> argument (takes precedence over the environment variable).

特徴 / Features

  • 型安全 / Type-safe: coglog-core の型定義を MCP サーバーと共有 / Shares type definitions from coglog-core with the MCP server
  • 小さいバイナリ / Small binary: opt-level="z", LTO, panic="abort", strip
  • 完全互換 / Fully compatible: 他の全言語実装と同じ JSON 形式を入出力 / Reads and writes the same JSON format as all other language implementations

workspace 構成 / Workspace Structure

rust/
├── Cargo.toml          [workspace]
├── coglog-core/        コアライブラリ(型 + バリデーション + テスト) / Core library (types + validation + tests)
├── coglog/             既存 CLI クレート(v0.9.2 で viewer に転生予定) / Existing CLI crate (to become viewer in v0.9.2)
├── coglog-cli/         ← このクレート(v0.9.2 で bin 名を coglog-cli に統一予定) / This crate (bin will unify to coglog-cli in v0.9.2)
└── coglog-mcp/         MCP サーバー / MCP server

データ互換性 / Data Compatibility

coglogcoglog-cli は同じ $HOME/.coglog/ (または $COGLOG_DIR)を参照し、完全にデータ互換です。片方で書いて他方で読むことができます。

coglog and coglog-cli share the same $HOME/.coglog/ (or $COGLOG_DIR) and are fully data-compatible. You can write with one and read with the other.

詳細 / Details

DESIGN-v0.9.1.md

ライセンス / License

MIT