1

WIKI_CLI

stan44 edited this page 2026-02-22 02:29:36 -06:00

Table of Contents

• CLI Reference
• Basic Usage
• Vault Commands
• Search Commands
• Server Commands
• AI Chat Command
• Devices Command
• Common Errors

CLI Reference

Project Journal includes a command-line interface under journal.cli.main.

Basic Usage

python -m journal.cli.main --help

Vault Commands

Load encrypted vaults:

python -m journal.cli.main vault load

Save vaults:

python -m journal.cli.main vault save

Notes:

• Vault commands prompt for password.
• Vault files are monthly and encrypted.

Search Commands

Search by text:

python -m journal.cli.main search "shutdown"

Search with filters:

python -m journal.cli.main search "trigger" --tag co-parent --type !TRIGGER --start-date 2026-02-01 --end-date 2026-02-21

Search by section:

python -m journal.cli.main search "anxiety" --section "Mental / Emotional Snapshot"

Search checkbox states:

python -m journal.cli.main search --checked Masking
python -m journal.cli.main search --unchecked Shutdown

Server Commands

Start server:

python -m journal.cli.main server start

Stop server:

python -m journal.cli.main server stop

AI Chat Command

python -m journal.cli.main chat "Summarize my last week patterns."

Devices Command

List microphones:

python -m journal.cli.main devices list

Common Errors

• No decrypted journal entries found: run vault load first.
• Date parsing errors: use YYYY-MM-DD for date filters.
• No microphone listed: check device permissions and drivers.