# 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,cron} ...
dkb v0.1.2
Developer Knowledge Base - Fetch and organize documentation locally for vibe coding with Claude Code
positional arguments:
{add,remove,update,status,claude,cron}
Available commands
add Add a new repository
remove Remove a repository
update Update all repositories
status Show status of all repositories
claude Regenerate CLAUDE.md file
cron Run continuous update loop
options:
-h, --help show this help message and exit
Examples:
dkb add vue https://github.com/vuejs/docs.git src/guide src/api
dkb remove vue
dkb update
dkb status
# Add a repository with specific paths
$ dkb add orpc https://github.com/unnoq/orpc.git apps/content/docs
Fetching orpc from https://github.com/unnoq/orpc.git
Branch: main
Paths: apps/content/docs
✓ orpc updated
# Show status - note the newly added 'orpc' repository
$ dkb status
Knowledge Base Status
drizzle no-tags eb8d0dd2 25m ago
nextjs no-tags 81f0c764 31m ago
orpc v1.6.4 99032307 0m ago # <-- just added!
turborepo no-tags 6c85c5ae 29m ago
uv no-tags c3f13d25 19m ago
# Update all repositories
$ dkb update
# Remove a repository
$ dkb remove drizzle
✗ drizzle removed
```
## Configuration
Docs stored in `$XDG_DATA_HOME/dkb/` (defaults to `~/.local/share/dkb/`)
Configuration file: `$XDG_DATA_HOME/dkb/config.json`
## TODO
- [ ] UX should be `dkb add https://github.com/astral-sh/uv/tree/main/docs`
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/4c/50/09575e340e2b22d2e3913ff12ce95ebbb1ff3a09879c8ab8c66dbc9bc825/dkb-0.1.2.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,cron} ...\n\ndkb v0.1.2\n\nDeveloper Knowledge Base - Fetch and organize documentation locally for vibe coding with Claude Code\n\npositional arguments:\n {add,remove,update,status,claude,cron}\n Available commands\n add Add a new repository\n remove Remove a repository\n update Update all repositories\n status Show status of all repositories\n claude Regenerate CLAUDE.md file\n cron Run continuous update loop\n\noptions:\n -h, --help show this help message and exit\n\nExamples:\n dkb add vue https://github.com/vuejs/docs.git src/guide src/api\n dkb remove vue\n dkb update\n dkb status\n\n# Add a repository with specific paths\n$ dkb add orpc https://github.com/unnoq/orpc.git apps/content/docs\nFetching orpc from https://github.com/unnoq/orpc.git\nBranch: main\nPaths: apps/content/docs\n\u2713 orpc updated\n\n# Show status - note the newly added 'orpc' repository\n$ dkb status\nKnowledge Base Status\n\ndrizzle no-tags eb8d0dd2 25m ago\nnextjs no-tags 81f0c764 31m ago\norpc v1.6.4 99032307 0m ago # <-- just added!\nturborepo no-tags 6c85c5ae 29m ago\nuv no-tags c3f13d25 19m ago\n\n# Update all repositories\n$ dkb update\n\n# Remove a repository\n$ dkb remove drizzle\n\u2717 drizzle removed\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## TODO\n\n- [ ] UX should be `dkb add https://github.com/astral-sh/uv/tree/main/docs`\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Developer Knowledge Base - Fetch and organize documentation locally for vibe coding with Claude Code",
"version": "0.1.2",
"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": "9876eea60f282e13590048d21c8bb8ce8522351786aec5dfd9036fd6339d54a8",
"md5": "a44198f59ffe9fc3c7dc9714fd7d247a",
"sha256": "6961fb6cefe2944ecb8656321973932e56eefc6bf21f42f46ad044a7955b5f67"
},
"downloads": -1,
"filename": "dkb-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a44198f59ffe9fc3c7dc9714fd7d247a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 190423,
"upload_time": "2025-07-15T17:20:43",
"upload_time_iso_8601": "2025-07-15T17:20:43.809679Z",
"url": "https://files.pythonhosted.org/packages/98/76/eea60f282e13590048d21c8bb8ce8522351786aec5dfd9036fd6339d54a8/dkb-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4c5009575e340e2b22d2e3913ff12ce95ebbb1ff3a09879c8ab8c66dbc9bc825",
"md5": "71077cf772ebea1975b031be8441a2b7",
"sha256": "5fb94cf42944922d20e358284ceb09f711c23aac2232643760d29540d78f4f88"
},
"downloads": -1,
"filename": "dkb-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "71077cf772ebea1975b031be8441a2b7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 186321,
"upload_time": "2025-07-15T17:20:45",
"upload_time_iso_8601": "2025-07-15T17:20:45.405289Z",
"url": "https://files.pythonhosted.org/packages/4c/50/09575e340e2b22d2e3913ff12ce95ebbb1ff3a09879c8ab8c66dbc9bc825/dkb-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-15 17:20:45",
"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
