clawhub/docs
Onur 4ae0406948
refactor: rename internal clawdhub package path (#1490)
* refactor: rename internal clawdhub package path

* fix: update workflow paths after clawhub dir rename

* fix: preserve old tag npm release compatibility

---------

Co-authored-by: Onur <onur@solmaz.io>
2026-04-02 17:50:33 +02:00
..
plans docs: add plugin hosting plan 2026-03-20 10:29:47 -07:00
acceptable-usage.md docs: clarify abuse policy for leaked data and account farming 2026-03-23 19:42:20 -07:00
api.md fix: raise http api rate limits 2026-03-23 19:06:49 -07:00
architecture.md refactor: rename internal clawdhub package path (#1490) 2026-04-02 17:50:33 +02:00
auth.md docs: update repository guidelines and improve formatting across multiple files 2026-03-18 21:56:01 -05:00
cli.md refactor: rename internal clawdhub package path (#1490) 2026-04-02 17:50:33 +02:00
deploy.md ops: add guarded npm release workflow for clawhub cli (#1487) 2026-04-02 16:45:08 +02:00
diffing.md docs: update repository guidelines and improve formatting across multiple files 2026-03-18 21:56:01 -05:00
github-import.md [codex] streamline plugin publish flow (#1373) 2026-03-29 02:37:58 -07:00
http-api.md fix: allow package downloads while VT scan is pending 2026-03-28 02:54:10 +00:00
manual-testing.md [codex] streamline plugin publish flow (#1373) 2026-03-29 02:37:58 -07:00
mintlify.md docs: update repository guidelines and improve formatting across multiple files 2026-03-18 21:56:01 -05:00
orgs.md feat: add publisher org ownership 2026-03-23 03:27:08 -07:00
quickstart.md [codex] streamline plugin publish flow (#1373) 2026-03-29 02:37:58 -07:00
README.md docs: update repository guidelines and improve formatting across multiple files 2026-03-18 21:56:01 -05:00
security.md fix: allow package downloads while VT scan is pending 2026-03-28 02:54:10 +00:00
skill-format.md docs: update repository guidelines and improve formatting across multiple files 2026-03-18 21:56:01 -05:00
soul-format.md docs: update repository guidelines and improve formatting across multiple files 2026-03-18 21:56:01 -05:00
spec.md feat: reserve official handles and package archives 2026-03-22 12:48:47 -07:00
telemetry.md docs: update repository guidelines and improve formatting across multiple files 2026-03-18 21:56:01 -05:00
troubleshooting.md [codex] streamline plugin publish flow (#1373) 2026-03-29 02:37:58 -07:00
webhook.md docs: update repository guidelines and improve formatting across multiple files 2026-03-18 21:56:01 -05:00

summary read_when
Documentation index + reading order.
New contributor onboarding
Looking for the right doc

Docs

Reading order (new contributor):

  1. README.md (repo root): run locally.
  2. docs/quickstart.md: end-to-end: search → install → publish → sync.
  3. docs/architecture.md: how the pieces fit (TanStack Start + Convex + CLI).
  4. docs/skill-format.md: what a “skill” is on disk + on the registry.
  5. docs/cli.md: CLI reference (flags, config, lockfiles, sync rules).
  6. docs/http-api.md: HTTP endpoints used by the CLI + public API.
  7. docs/auth.md: GitHub OAuth + API tokens + CLI loopback login.
  8. docs/deploy.md: Convex + Vercel deployment + rewrites.
  9. docs/troubleshooting.md: common failure modes.

Feature/ops docs (already present):

  • docs/spec.md: product + implementation spec (data model + flows).
  • docs/security.md: moderation, reporting, bans, upload gating.
  • docs/telemetry.md: what clawhub sync reports; opt-out.
  • docs/webhook.md: Discord webhook events/payload.
  • docs/diffing.md: version-to-version diff UI spec.
  • docs/manual-testing.md: CLI smoke scripts.

Docs tooling:

  • docs/mintlify.md: publish these docs with Mintlify.