Crucible Documentation

What Makes Crucible Different

Memory and knowledge are too fundamental to be an afterthought. Most AI tools treat conversations as disposable — Crucible makes them the foundation.

• Knowledge-grounded agents. Precognition auto-injects relevant context from your knowledge graph before each LLM turn. Block-level embeddings power semantic search at paragraph granularity. The more you use it, the smarter your agents get.
• Sessions are notes. Every chat saves as markdown in your kiln. Search them, link them with wikilinks, version them in git. Conversations become permanent, connectable knowledge.
• Neovim-like architecture. Lua/Fennel plugins, TUI-first, headless daemon with RPC. Most behaviors beyond the knowledge core can be scripted.
• Bring any LLM. Ollama, OpenAI, Anthropic, local GGUF models — swap freely.
• Plaintext first. No proprietary formats. Files are the source of truth.

How It Compares

	Crucible	ChatGPT	Obsidian + AI	OpenClaw
Local-first	✅	❌	✅	✅
Sessions as markdown	✅	❌	❌	❌
Knowledge graph	✅	❌	✅	❌
Bring your own LLM	✅	❌	Partial	✅
Plugin system	✅ Lua/Fennel	❌	✅ JS	✅ TS
MCP server	✅	❌	❌	❌
Semantic search	✅ Block-level	❌	Plugin	❌
Setup time	~2 min	0	~5 min	2-7 hrs

Quick Start

# Install
cargo install --git https://github.com/Mootikins/crucible.git crucible-cli

# Start chatting
cru chat

# Or expose your knowledge base via MCP
cru mcp

Explore

Core Concepts

Learn about kilns, precognition, and the knowledge graph.

CLI Reference

Start a chat session, search your notes, or process your kiln.

Extend with Plugins

Write plugins in Lua or Fennel, add custom tools, or connect via MCP.

Configuration

Set up LLM providers, configure embeddings, and tune storage.