ctxdlisted

# ctxd Use `ctxd` first when the task is to extract context from supported work URLs. Supported URLs: - GitHub PR - Slack thread - Confluence page - Jira issue GitHub support is **pull requests only** (`github.com/<owner>/<repo>/pull/<n>`). Repo, file, blob, issue, gist, and commit URLs are **not** supported — `ctxd` exits with `Unsupported URL`. To read a public repo file or README, fetch the raw URL with `curl` / WebFetch instead; do not route it through `ctxd`. ## Why use it - It exports dense Markdown or text instead of forcing the model through many tool calls. - It leaves a stable local artifact that can be re-read, diffed, or shared. - It is better than connectors for bulk context export. ## Required config Do not assume `ctxd` works without credentials. Config file: - `~/.config/ctxd/config` Slack: - `SLACK_TOKEN` Confluence and Jira: - `CONFLUENCE_BASE_URL` - `CONFLUENCE_EMAIL` - `CONFLUENCE_API_TOKEN` GitHub PR: - valid `gh auth status` If auth is missing, say which key or login is required. ## Default commands Single item to stdout (cross-source recursion is off by default — only the primary URL is fetched): ```bash ctxd '<url>' -f text ``` Enable recursion to auto-expand supported URLs found in the output: ```bash ctxd '<url>' -f text --recurse-depth 1 ``` Confluence page tree: ```bash ctxd '<confluence-url>' -f text -r -O ``` Profile a slow export: ```bash ctxd '<url>' --profile ``` ## When to prefer ctxd over connectors Prefer `ctxd`