You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Feb 14, 2026. It is now read-only.
v0.6.0: Add incremental indexing, remove web crawling, fix casts and heading depth
- Incremental indexing via SHA-256 content hashes (only re-chunk changed files)
- --full flag to force complete rebuild
- Remove web crawling module and dependencies (cheerio, jsdom, readability, turndown)
- Fix unsafe TypeScript double-casts in search.ts
- Support heading depths h1-h6 in chunker (was h1-h3)
- Read CLI version from package.json instead of hardcoding
- Bump index version 2 → 3 with automatic migration
- Add searchAllIndexes for merged local+global search
- Add file glob filtering to search
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
refdocs add <source> -g # add to global ~/.refdocs/ store
72
66
73
67
# Search
@@ -93,21 +87,16 @@ refdocs remove ref-docs/laravel # remove a path from config
93
87
94
88
3.**Output** — human-readable by default, `--json` for structured consumption, `--raw` for piping. Each result includes source file, line range, and heading trail.
95
89
96
-
## Adding from the web
90
+
## Adding sources
97
91
98
-
`refdocs add`auto-detects the source type:
92
+
`refdocs add`supports two source types:
99
93
100
94
| Source | Behavior |
101
95
|--------|----------|
102
96
| Local path (`./docs`) | Adds directory to config |
103
97
| GitHub URL | Downloads `.md` files from the repo tarball |
104
-
|`.md` or `.txt` URL | Downloads the file directly |
105
-
| Any other URL | Fetches the page and converts HTML to markdown |
106
-
| Any URL + `--crawl`| Spiders the site, converting each page to markdown |
107
98
108
-
Single-page URLs are fetched with [Readability](https://github.com/mozilla/readability) (content extraction) + [Turndown](https://github.com/mixmark-io/turndown) (HTML-to-markdown). With `--crawl`, links are followed within the same origin up to `--depth` levels (default: 3) and `--max-pages` (default: 200).
109
-
110
-
All downloaded sources are tracked in `.refdocs.json` and can be re-pulled with `refdocs update`.
99
+
GitHub sources are tracked in `.refdocs.json` and can be re-pulled with `refdocs update`.
111
100
112
101
## Global docs
113
102
@@ -153,8 +142,5 @@ All fields optional. See [Configuration](docs/configuration.md) for details.
0 commit comments