Commands - ctxpack

Status and Setup

ctxpack
ctxpack setup [--force]
ctxpack skill # optionally install skill for agents
ctxpack help

ctxpack (no args) does not create files. If setup is missing, it tells you to run ctxpack setup.

Connect LLM providers

Connect:

ctxpack connect openai
ctxpack connect # interactive

Disconnect:

ctxpack disconnect openai
ctxpack disconnect --provider <id>
ctxpack disconnect # interactive (TTY)

Configuration

ctxpack config

Prints both project and global config, plus connected providers.

Server

ctxpack server [--port <n>]
ctxpack serve [--port <n>]

Ask and Search

ctxpack ask <query> [options]
ctxpack search <query> --raw
ctxpack search <query> --explore
ctxpack search <query> --research
ctxpack search <query> --research --async
ctxpack research-status <job-id>

Use ctxpack ask as the default command for question answering. ctxpack ask is an alias for ctxpack search --explore. Use ctxpack search directly when you need explicit modes like --raw or --research. Common options:

--resource, -r <name-or-id>
--mode <hybrid|text|vector>
--stream
--verbose, -v
--top-k <n>
--alpha <0-1>
--global, -g

Resources

Default resource scope is the current project. Use -g / --global for global resources.

ctxpack resources [--global]
ctxpack add <url-or-path> [--name <name>] [--type git|local] [--branch <branch>] [--commit <sha>] [--paths <a,b>] [--notes <text>] [--index] [--global]
ctxpack rm <resource-id> [--global]
ctxpack sync <name-or-id> [...] [--all] [--global]
ctxpack index <name-or-id> [...] [--all] [--sync] [--global]
ctxpack job <job-id>

sync: for git resources, pulls latest from remote; for local resources, refreshes local content state.
index: runs embedding/indexing.
index --sync: for git resources, syncs first then indexes.

Tool Commands

ctxpack grep <pattern> --resource <name-or-id> [--paths a,b] [--case-sensitive]
ctxpack read <filepath> --resource <name-or-id> [--start-line N] [--end-line N]
ctxpack ls --resource <name-or-id> [--path <subpath>]
ctxpack glob <pattern> --resource <name-or-id>

Remote Commands

ctxpack remote link --key <api-key> [--endpoint <url>]
ctxpack remote unlink
ctxpack remote add ...
ctxpack remote resources
ctxpack remote ask ...
ctxpack remote rm <resource-id>

Global API Options

--endpoint <url>   # Override API endpoint
--api-key <key>    # Override API key for this command

​Status and Setup

​Connect LLM providers

​Configuration

​Server

​Ask and Search

​Resources

​Tool Commands

​Remote Commands

​Global API Options