CLI Reference

The rubberduck-index CLI keeps a local project's semantic index in sync with the server, so your MCP-connected IDE always has fresh context to query against.

Get started
rubberduck-index init

Commands

CommandDescription
rubberduck-index initInitialize and index a project (prompts for token)
rubberduck-index syncSync changed files to server
rubberduck-index sync --forceRe-upload all files
rubberduck-index watchWatch for changes and auto-sync
rubberduck-index watch -dWatch in background (daemon mode)
rubberduck-index stopStop the background watcher
rubberduck-index statusShow local and server index status
rubberduck-index listList all your indexed projects
rubberduck-index removeRemove a project from the server

Optional Flags for init

FlagDescriptionDefault
--tokenBearer token (skip prompt)Prompted
--serverServer URL (or RUBBERDUCK_SERVER)semantic.rubberduck.com
--projectProject nameDirectory name
--includeFile patterns**/*.py
--no-watchDon't start watcherWatcher starts

Running watch -d once means you never have to manually sync again, every save is picked up and indexed in the background.