spikuit-cli 0.9.0

CLI interface for Spikuit (spkt command)

spikuit-cli

The spkt command — CLI for Spikuit, a knowledge base that gets smarter the more you use it.

⚠️ Pre-1.0 / under active development. Expect frequent breaking changes until v1.0.0.

spikuit-cli installs the spkt command and pulls in spikuit-core[engine] so you get the full Brain engine (FSRS + knowledge graph + spreading activation) out of the box.

pip install spikuit-cli
spkt --help

If you want the CLI plus everything else under one install target, use the spikuit metapackage instead.

Quick start

# Create a brain in the current directory
spkt init -p openai-compat \
  --base-url http://localhost:1234/v1 \
  --model text-embedding-nomic-embed-text-v1.5

# Ingest a source
spkt source ingest https://en.wikipedia.org/wiki/Monad_(category_theory) -d math

# Search the graph
spkt retrieve "What is a monad?"

# Review what's due (FSRS)
spkt neuron due
spkt neuron fire <id> -g fire

# Export a read-only bundle for a server
spkt export qabot --output ./brain.db

Resource-oriented commands

Resource	Subcommands
spkt neuron	add, list, inspect, remove, merge, due, fire
spkt synapse	add, remove, weight, list
spkt source	learn, list, inspect, update, refresh
spkt domain	list, rename, merge, audit
spkt community	detect, list
spkt skills	install, list

Plus root commands: init, config, stats, retrieve, quiz, visualize, embed-all, export, import, diagnose, progress.

All commands support --json for machine-readable output and --brain <path> to target a specific Brain.

Links

• Documentation: https://takyone.github.io/spikuit/
• CLI reference: https://takyone.github.io/spikuit/cli/
• Source: https://github.com/takyone/spikuit
• Issues: https://github.com/takyone/spikuit/issues

License

Apache-2.0