English | 简体中文
Auto-sync Claude Code conversations to your knowledge base. Hooks into Claude Code's Stop event, parses JSONL conversation logs, deduplicates by session, and syncs via configurable output adapters.
Note: Use
pip3on macOS. The systempipmay point to Python 2 which is no longer supported.
pip3 install git+https://github.com/aichatlog/aichatlog-plugin-cc.gitIf you see a warning that the script is not on PATH:
WARNING: The script aichatlog is installed in '/Users/you/Library/Python/3.x/bin' which is not on PATH.
Add it to your shell profile:
# For zsh (default on macOS)
echo 'export PATH="$HOME/Library/Python/3.9/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# Or use the full path directly
python3 -m aichatlog.core installThen register the Claude Code hook:
aichatlog installRestart Claude Code to activate.
/plugin marketplace add https://github.com/aichatlog/aichatlog.git
Then install aichatlog from the marketplace.
aichatlog setup --adapter=fns --url=http://localhost:37240 --token=YOUR_TOKEN --vault=MyVaultAdapters: fns (Obsidian via FNS), local (write .md files), git (auto-commit), server (push to aichatlog-server).
| Command | Description |
|---|---|
aichatlog setup |
Configure adapter and settings |
aichatlog status |
Show config and sync stats |
aichatlog run |
Manually sync latest conversation |
aichatlog export |
Bulk sync all conversations |
aichatlog test |
Test adapter connectivity |
aichatlog web |
Launch web dashboard |
aichatlog reparse |
Force re-parse all conversations from JSONL |
In Claude Code, use /aichatlog:web to open the dashboard.
Run a dev instance alongside production using a separate config directory:
# Run from source with isolated config (does not affect production)
AICHATLOG_CONFIG_DIR=~/.config/aichatlog-dev python3 src/aichatlog/core.py web --port=8766# Update
pip3 install --upgrade git+https://github.com/aichatlog/aichatlog-plugin-cc.git
# Uninstall
aichatlog uninstall # remove hook
pip3 uninstall aichatlog-plugin