Skip to main content

Developer Knowledge Base - Fetch and organize documentation locally for vibe coding with Claude Code

Project description

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.

# ~/CLAUDE.md
+ @~/.local/share/dkb/CLAUDE.md

Now on your next Claude Code session it will know how to use it.

Claude integration

Local .md files > MCP

Install

# Install with uv
uv tool install dkb

# Or with pipx
pipx install dkb

Usage

$ dkb -h
usage: dkb [-h] {add,remove,update,status,claude,cron} ...

dkb v0.2.6

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 deno https://github.com/denoland/docs.git
  dkb add tailwind https://github.com/tailwindlabs/tailwindcss.com.git src/docs
  dkb add gramio https://github.com/gramiojs/documentation.git docs --version-url https://github.com/gramiojs/gramio.git
  dkb remove tailwind
  dkb update
  dkb status

# Add a repository (entire repo)
$ dkb add deno https://github.com/denoland/docs.git

Fetching deno from https://github.com/denoland/docs.git
Branch: main
Paths: <entire repository>
✓ deno fetched
✓ 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

TODO

  • UX should be dkb add https://github.com/astral-sh/uv/tree/main/docs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dkb-0.2.6.tar.gz (189.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dkb-0.2.6-py3-none-any.whl (194.2 kB view details)

Uploaded Python 3

File details

Details for the file dkb-0.2.6.tar.gz.

File metadata

  • Download URL: dkb-0.2.6.tar.gz
  • Upload date:
  • Size: 189.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for dkb-0.2.6.tar.gz
Algorithm Hash digest
SHA256 cc3737094269f8d287b110c425c757eea238c578a9c393ea1c314edef795eb57
MD5 b875076b7466fd1b0d47bd3a31493f83
BLAKE2b-256 2fa17c77213bc580b0e5a89f0257d0f315344d54305a38eb29b03bd79a74f813

See more details on using hashes here.

Provenance

The following attestation bundles were made for dkb-0.2.6.tar.gz:

Publisher: release.yml on adriangalilea/dkb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file dkb-0.2.6-py3-none-any.whl.

File metadata

  • Download URL: dkb-0.2.6-py3-none-any.whl
  • Upload date:
  • Size: 194.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for dkb-0.2.6-py3-none-any.whl
Algorithm Hash digest
SHA256 3aaf6da7df5dc1b634c4fd41b832d5a96614cf66403b47377aa2ca65f7403a06
MD5 9805e78fda77d8a44a980d0c3cb3767b
BLAKE2b-256 a48fbb001a4cd62e997af96973de7b6e9e8d4b57d21681b47ea0c86ef0a15382

See more details on using hashes here.

Provenance

The following attestation bundles were made for dkb-0.2.6-py3-none-any.whl:

Publisher: release.yml on adriangalilea/dkb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page