# dkb - Developer Knowledge Base
Local documentation manager for vibe coding with Claude Code.
> [!NOTE]
> ✨ **Perfect for Claude Code**
>
> `dkb` automatically generates a `CLAUDE.md` file that provides context about your local documentation cache and `dkb` usage instructions.
>
> ```diff
> # ~/CLAUDE.md
> + @~/.local/share/dkb/CLAUDE.md
> ```
> Now on your next Claude Code session it will know how to use it.
> Local .md files > MCP
## Install
```bash
# Install with uv
uv tool install dkb
# Or with pipx
pipx install dkb
```
## Usage
```bash
$ dkb -h
usage: dkb [-h] {add,remove,update,status,claude} ...
dkb v1.1.0
Developer Knowledge Base - Fetch and organize documentation locally for vibe coding with Claude Code
positional arguments:
{add,remove,update,status,claude}
Available commands
add Add a new repository
remove Remove a repository
update Update repositories
status Show status of all repositories
claude Regenerate CLAUDE.md file
options:
-h, --help show this help message and exit
Examples:
dkb add https://github.com/denoland/docs.git
dkb add tailwindlabs/tailwindcss.com/src/docs
dkb add gramiojs/documentation/docs --version-url gramiojs/gramio
dkb add https://github.com/astral-sh/uv/tree/main/docs
dkb remove tailwind
dkb update
dkb status
# Add a repository (entire repo)
$ dkb add https://github.com/denoland/docs.git
📦 Adding docs...
✓ 2.4.2
✓ Updated /Users/you/.local/share/dkb/CLAUDE.md
# Show status with rich formatting
$ dkb status
Knowledge Base Status
┏━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┓
┃ Repository ┃ Version ┃ Docs ┃ Source ┃ Last Updated ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━┩
│ better-auth │ 1.2.12 │ better-auth/better-auth │ - │ 25m ago │
│ deno │ 2.4.2 │ denoland/docs │ denoland/deno │ 25m ago │
│ nextjs │ 15.4.2 │ vercel/next.js │ - │ 24m ago │
│ tailwind │ 4.1.11 │ tailwindlabs/tailwindcss.com │ tailwindlabs/tailwindcss │ 12m ago │
│ uv │ 0.8.0 │ astral-sh/uv │ - │ 33m ago │
└──────────────┴─────────┴──────────────────────────┴─────────────────────────┴──────────────┘
# Update all repositories
$ dkb update
Updating deno... ✓ updated
Updating nextjs... - unchanged
Updating tailwind... - unchanged
Updating uv... - unchanged
Updated: deno
✓ Updated /Users/you/.local/share/dkb/CLAUDE.md
```
## Configuration
Docs stored in `$XDG_DATA_HOME/dkb/` (defaults to `~/.local/share/dkb/`)
Configuration file: `$XDG_DATA_HOME/dkb/config.json`
## Features
- ✨ **Auto-naming** - No need to specify names, automatically derived from repositories
- 🎯 **Path-specific URLs** - Add only the docs you need: `dkb add owner/repo/path`
- 🔗 **Multiple URL formats**:
- Full URLs: `https://github.com/astral-sh/uv/tree/main/docs`
- Shorthand: `tailwindlabs/tailwindcss.com/src/docs`
- Classic: `https://github.com/denoland/docs.git`
- 📦 **Version tracking** - Track versions from a different repository with `--version-url`
- 🤖 **Claude Code integration** - Auto-generates CLAUDE.md for seamless AI assistance
Raw data
{
"_id": null,
"home_page": null,
"name": "dkb",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "ai, claude-code, developer-tools, documentation, git, knowledge-base, llm, markdown, vibe-coding",
"author": null,
"author_email": "Adrian Galilea <adriangalilea@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/33/20/d054749f180542335d9dfc0503da46906e7b9be1867cb92d8a02785ea2e9/dkb-1.1.0.tar.gz",
"platform": null,
"description": "# dkb - Developer Knowledge Base\n\nLocal documentation manager for vibe coding with Claude Code.\n\n\n> [!NOTE]\n> \u2728 **Perfect for Claude Code**\n> \n> `dkb` automatically generates a `CLAUDE.md` file that provides context about your local documentation cache and `dkb` usage instructions.\n> \n> ```diff\n> # ~/CLAUDE.md\n> + @~/.local/share/dkb/CLAUDE.md\n> ```\n> Now on your next Claude Code session it will know how to use it.\n\n\n\n> Local .md files > MCP\n\n## Install\n\n```bash\n# Install with uv\nuv tool install dkb\n\n# Or with pipx\npipx install dkb\n```\n\n## Usage\n\n```bash\n$ dkb -h\nusage: dkb [-h] {add,remove,update,status,claude} ...\n\ndkb v1.1.0\n\nDeveloper Knowledge Base - Fetch and organize documentation locally for vibe coding with Claude Code\n\npositional arguments:\n {add,remove,update,status,claude}\n Available commands\n add Add a new repository\n remove Remove a repository\n update Update repositories\n status Show status of all repositories\n claude Regenerate CLAUDE.md file\n\noptions:\n -h, --help show this help message and exit\n\nExamples:\n dkb add https://github.com/denoland/docs.git\n dkb add tailwindlabs/tailwindcss.com/src/docs\n dkb add gramiojs/documentation/docs --version-url gramiojs/gramio\n dkb add https://github.com/astral-sh/uv/tree/main/docs\n dkb remove tailwind\n dkb update\n dkb status\n\n# Add a repository (entire repo)\n$ dkb add https://github.com/denoland/docs.git\n\n\ud83d\udce6 Adding docs...\n \u2713 2.4.2\n \u2713 Updated /Users/you/.local/share/dkb/CLAUDE.md\n\n# Show status with rich formatting\n$ dkb status\n\n Knowledge Base Status\n\u250f\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2533\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2533\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2533\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2533\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2513\n\u2503 Repository \u2503 Version \u2503 Docs \u2503 Source \u2503 Last Updated \u2503\n\u2521\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2529\n\u2502 better-auth \u2502 1.2.12 \u2502 better-auth/better-auth \u2502 - \u2502 25m ago \u2502\n\u2502 deno \u2502 2.4.2 \u2502 denoland/docs \u2502 denoland/deno \u2502 25m ago \u2502\n\u2502 nextjs \u2502 15.4.2 \u2502 vercel/next.js \u2502 - \u2502 24m ago \u2502\n\u2502 tailwind \u2502 4.1.11 \u2502 tailwindlabs/tailwindcss.com \u2502 tailwindlabs/tailwindcss \u2502 12m ago \u2502\n\u2502 uv \u2502 0.8.0 \u2502 astral-sh/uv \u2502 - \u2502 33m ago \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n\n# Update all repositories\n$ dkb update\n\nUpdating deno... \u2713 updated\nUpdating nextjs... - unchanged\nUpdating tailwind... - unchanged\nUpdating uv... - unchanged\n\nUpdated: deno\n\u2713 Updated /Users/you/.local/share/dkb/CLAUDE.md\n```\n\n## Configuration\n\nDocs stored in `$XDG_DATA_HOME/dkb/` (defaults to `~/.local/share/dkb/`)\n\nConfiguration file: `$XDG_DATA_HOME/dkb/config.json`\n\n## Features\n\n- \u2728 **Auto-naming** - No need to specify names, automatically derived from repositories\n- \ud83c\udfaf **Path-specific URLs** - Add only the docs you need: `dkb add owner/repo/path`\n- \ud83d\udd17 **Multiple URL formats**:\n - Full URLs: `https://github.com/astral-sh/uv/tree/main/docs`\n - Shorthand: `tailwindlabs/tailwindcss.com/src/docs`\n - Classic: `https://github.com/denoland/docs.git`\n- \ud83d\udce6 **Version tracking** - Track versions from a different repository with `--version-url`\n- \ud83e\udd16 **Claude Code integration** - Auto-generates CLAUDE.md for seamless AI assistance\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Developer Knowledge Base - Fetch and organize documentation locally for vibe coding with Claude Code",
"version": "1.1.0",
"project_urls": {
"Homepage": "https://github.com/adriangalilea/dkb",
"Issues": "https://github.com/adriangalilea/dkb/issues",
"Repository": "https://github.com/adriangalilea/dkb"
},
"split_keywords": [
"ai",
" claude-code",
" developer-tools",
" documentation",
" git",
" knowledge-base",
" llm",
" markdown",
" vibe-coding"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b43e3e71b4de10007546f189d3578cf1758500e380f2ae56a68eebc2662a9c37",
"md5": "7ee1b52619f2cdff10893a570df29aa0",
"sha256": "ef38094f2ddeaef33214a1ae96d20de509a1095996ef0b4cca84cf7721a3c92d"
},
"downloads": -1,
"filename": "dkb-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7ee1b52619f2cdff10893a570df29aa0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 195313,
"upload_time": "2025-08-05T16:21:18",
"upload_time_iso_8601": "2025-08-05T16:21:18.691085Z",
"url": "https://files.pythonhosted.org/packages/b4/3e/3e71b4de10007546f189d3578cf1758500e380f2ae56a68eebc2662a9c37/dkb-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3320d054749f180542335d9dfc0503da46906e7b9be1867cb92d8a02785ea2e9",
"md5": "377ac9611bed348ab08b5e60afa7644b",
"sha256": "1a2cf892b5a76c76ec377f9a2d058a5479de5eaebe5974b926c72b18dea76557"
},
"downloads": -1,
"filename": "dkb-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "377ac9611bed348ab08b5e60afa7644b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 190554,
"upload_time": "2025-08-05T16:21:20",
"upload_time_iso_8601": "2025-08-05T16:21:20.152601Z",
"url": "https://files.pythonhosted.org/packages/33/20/d054749f180542335d9dfc0503da46906e7b9be1867cb92d8a02785ea2e9/dkb-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-05 16:21:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "adriangalilea",
"github_project": "dkb",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "dkb"
}
JSON
