@yologdev/core
v0.3.0
Published
Yocore - headless service for AI coding sessions
Readme
@yologdev/core
Headless service for watching, parsing, storing, and serving AI coding sessions.
Yocore is the core engine behind Yolog — a platform that archives and visualizes AI pair programming sessions from Claude Code, Cursor, and other AI coding assistants.
Install
npm install -g @yologdev/corePre-built binaries are included for:
| Platform | Architecture | |----------|-------------| | macOS | Apple Silicon (ARM64) | | macOS | Intel (x64) | | Linux | x64 | | Windows | x64 |
Quick Start
# Initialize default config
yocore --init
# Start the HTTP server (default: 127.0.0.1:19420)
yocore
# Start in MCP mode (for Claude Code integration)
yocore --mcp
# Custom port
yocore --port 8080Features
- Session Watching — Automatically watches folders for new AI coding sessions
- Multi-Parser Support — Parses Claude Code, OpenClaw, and other AI assistant formats
- Full-Text Search — SQLite FTS5-powered search across all sessions and memories
- Memory System — Extract and organize decisions, facts, preferences, and tasks
- HTTP API — RESTful API for session replay, search, and memory management
- MCP Server — Model Context Protocol integration for AI assistants
- LAN Discovery — Automatic instance discovery via mDNS/Bonjour
- Lifeboat Pattern — Session context preservation across context compaction
Configuration
Config file at ~/.yolog/config.toml:
[server]
port = 19420
host = "127.0.0.1"
# api_key = "optional-secret"
# instance_name = "My Workstation"
[database]
path = "~/.local/share/yocore/yocore.db"
[[watch]]
path = "~/.claude/projects"
parser = "claude_code"
[ai]
enabled = falseMCP Tools
When running in MCP mode (yocore --mcp):
| Tool | Description |
|------|-------------|
| yolog_search_memories | Hybrid keyword + semantic search |
| yolog_get_project_context | Get project overview with categorized memories |
| yolog_get_recent_memories | Get memories from recent sessions |
| yolog_get_session_context | Get session state with lifeboat pattern |
| yolog_save_lifeboat | Save session state before context compaction |
Links
- GitHub — Source code, issues, and full documentation
- Yolog Desktop — GUI companion app
- yoskill — Claude Code skill pack
- Changelog
License
MIT
