Compare commits

..
372 Commits
Author SHA1 Message Date
Peter Steinberger f53be5c8d2 docs: reset changelog for next release 2026-02-10 13:22:09 +01:00
Peter Steinberger 03164fe8b1 chore: release 0.6.0 2026-02-10 13:20:16 +01:00
Peter Steinberger 81b53f0b20 feat: add ban reasons to moderation 2026-02-10 13:11:47 +01:00
theonejvo 75474075b1 fix(vt): self-sustaining VT scanning + working stats
- getStatsInternal: derive VT stats from moderationReason instead of
  N+1 version lookups that hit the 16MB byte limit
- UI: read cached vtAnalysis from version docs instead of hitting the
  live VT API on every page view
- Backfill: add vt-cache-backfill cron (30min) with self-scheduling to
  drain the backlog of skills missing cached vtAnalysis
- Daily rescan: cursor-based batching (100/batch) with self-scheduling
  instead of loading all skills in one shot
2026-02-10 20:39:27 +11:00
theonejvo 5946a08267 fix(convex): reduce write conflicts across hot paths
- downloads:increment: remove unnecessary db.get that added skill doc
  to read set, causing conflicts with the stat processing cron
- users:ensure: only patch when there are real field changes, skip
  unconditional updatedAt bump that forced a write on every call
- comments: route stats through event sourcing (insertStatEvent) instead
  of synchronous read-modify-write on the skill doc
- rateLimits: split into query-first check + conditional mutation so
  denied requests are conflict-free reads
- skillStatEvents: reduce MAX_SKILLS_PER_RUN from 500 to 50 to shrink
  the write set and lower conflict probability with concurrent mutations

Co-Authored-By: theonejvo <theonejvo@users.noreply.github.com>
2026-02-10 17:58:43 +11:00
theonejvo b997f5e749 fix(security): block downloads for unscanned/moderated skills
The download endpoint now checks moderation status before serving zips:

- Pending scan (423): "This skill is pending a security scan by VirusTotal. Please try again in a few minutes."
- Malicious (403): "Blocked: this skill has been flagged as malicious by VirusTotal and cannot be downloaded."
- Removed (410): "This skill has been removed by a moderator."
- Hidden (403): "This skill is currently unavailable."

Closes the supply chain gap where a newly published version could be
downloaded before VT scanning completed.
2026-02-08 23:49:23 +11:00
theonejvo 27f300bda5 chore: trigger CI 2026-02-08 16:55:41 +11:00
theonejvo 557f11985d chore: fix lint warnings (unused vars, formatting) 2026-02-08 16:49:43 +11:00
theonejvo 40f9ba5697 chore(clawhub): bump version to 0.5.1 2026-02-08 16:43:45 +11:00
theonejvo 26a353efc7 feat(cli): enforce VT Code Insight moderation on install/update
CLI now checks moderation status before installing skills:

**Suspicious skills** - Shows warning and requires confirmation:
```
⚠️  Warning: "skill-name" is flagged as suspicious by VirusTotal Code Insight.
   This skill may contain risky patterns (crypto keys, external APIs, eval, etc.)
   Review the skill code before use.

? Install anyway? (y/N)
```
Non-interactive mode requires --force flag.

**Malicious skills** - Blocked entirely:
```
✖ Blocked: skill-name is flagged as malicious
Error: This skill has been flagged as malware and cannot be installed.
```

Changes:
- API now returns `moderation` field with `isSuspicious` and `isMalwareBlocked`
- CLI schema updated to expect moderation field
- cmdInstall and cmdUpdate enforce moderation checks

Thanks to @zackkorman for raising this issue.
2026-02-08 16:36:55 +11:00
theonejvo 990d3d730d feat: VT backfill infrastructure and 99.7% scan coverage
- Add getQuickStatsInternal for fast dashboard stats
- Fix getStatsInternal to include null moderationStatus skills
- Add syncModerationReasons to sync vtAnalysis → moderationReason
- Add requestReanalysisForPending to push stuck skills to VT
- Add backfillActiveSkillsVTCache improvements for efficiency
- Add fixNullModerationStatus for legacy skill cleanup
- Add getPendingVTSkillsInternal for monitoring
- Fix getActiveSkillsMissingVTCacheInternal to avoid read limits

Backfilled 5,000+ skills to 99.7% VT Code Insight coverage:
- Clean: 3,537 (70.5%)
- Suspicious: 1,336 (26.6%)
- Malicious: 123 (2.5%)
- Pending: 17 (0.3%)
2026-02-08 15:37:11 +11:00
Peter Steinberger 75f7a93fe8 fix: restore soft-deleted users on reauth (#106) (thanks @mkrokosz) 2026-02-06 16:58:19 -08:00
Matthew KrokoszandClaude Opus 4.5 bc51ab4b5f fix: Convert userId to string for targetId comparison
The auditLogs.targetId field is v.string() in the schema, so explicitly
convert the Id<'users'> to string to ensure type-safe comparison.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-06 16:58:19 -08:00
Matthew KrokoszandClaude Opus 4.5 82fce7f34f fix: Restore soft-deleted users on re-authentication (with ban check)
Users who deleted their account were unable to sign in again with the
same GitHub account. The OAuth flow would complete but the user would
remain logged out due to the `deletedAt` field being set.

This fix adds a `createOrUpdateUser` callback that:
1. Detects soft-deleted users during OAuth
2. Checks audit logs to determine if user was BANNED vs SELF-DELETED
3. If banned → throws error "This account has been suspended"
4. If self-deleted → clears `deletedAt` to restore account

Security: Both `deleteAccount` and `banUser` set the same `deletedAt`
field. This fix ensures banned users cannot restore their accounts.

Performance: The callback runs on every sign-in, but the audit log
query ONLY executes for soft-deleted users (rare edge case). Normal
active users just hit a single `if` check - no extra queries. When
the audit log query does run, it uses the `by_target` index for
efficient lookup.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-06 16:58:19 -08:00
Peter Steinberger 5f4fa02b42 fix: update footer branding to OpenClaw (#122) (thanks @jontsai) 2026-02-06 16:52:01 -08:00
Jonathan Tsai cfef87059b fix: update footer branding from Clawdbot to OpenClaw
- Change 'A Clawdbot project' to 'An OpenClaw project'
- Update link from clawd.bot to openclaw.ai
2026-02-06 16:52:01 -08:00
Peter Steinberger b948b216c6 fix: backfill empty handles in ensure (#158) (thanks @adlai88) 2026-02-06 16:24:28 -08:00
adlai88 f156b909e7 fix: handle empty-string handle in ensure() fallback
`??` (nullish coalescing) treats `""` as a valid value, so users
with `handle=""` never get a fallback derived from name/email.
Change to `||` so empty strings fall through to the next candidate.

This affects any user whose handle field is an empty string rather
than null/undefined — e.g. early accounts or migration artifacts.
2026-02-06 16:24:28 -08:00
nikniknikbbb 0b46210f61 Update README.md (#140) 2026-02-06 16:12:04 -08:00
theonejvo 03eee4b6de fix: self-healing VT scan queue
- Batch size 100 (was 10) - process more per run
- Skip skills checked in last 60 min - avoid hammering same hashes
- After 10 failed checks, mark as pending.scan.stale - drops from queue
- Track scanLastCheckedAt and scanCheckCount on skills
- Add TODO for webhook/notification setup
2026-02-07 00:20:49 +11:00
theonejvo 09ffaba89b fix: randomize VT scan queue + add health monitoring
- Fetch 5x batch size and shuffle to avoid queue head-blocking
- Add getScanQueueHealthInternal to monitor queue status
- Log warnings when queue is unhealthy (>50 pending or >24h stale)
- Return health stats from pollPendingScans
2026-02-07 00:06:03 +11:00
theonejvo b39f203b12 fix: use yellow styling for suspicious code insight blocks
- Malicious verdicts keep red border/background
- Suspicious verdicts now use yellow/amber to match badge color
2026-02-06 20:40:41 +11:00
theonejvo 4002bb615d chore: fix lint errors 2026-02-06 16:39:27 +11:00
theonejvo 583e391d83 chore: add friendly wait message for pending scans 2026-02-06 16:37:24 +11:00
theonejvo 55ae6e1eb7 feat: add VT rescan trigger and backfill function
- Add requestRescan() to trigger Code Insight via /analyse endpoint
- Update pollPendingScans to request rescan when no Code Insight
- Add backfillPendingScans for one-time backlog clearing
2026-02-06 16:36:49 +11:00
theonejvo b4fe685a46 chore: fix lint formatting 2026-02-06 16:01:53 +11:00
theonejvo a93de9cf92 feat: add cron job to poll VT for pending scan results
- Add pollPendingScans action to vt.ts that checks VT for Code Insight verdicts
- Add getPendingScanSkillsInternal query to get skills awaiting scan
- Add vt-pending-scans cron job running every 5 minutes
- Updates skill moderation status when VT analysis is complete
2026-02-06 15:51:24 +11:00
theonejvo 74bf5946e1 chore: fix lint formatting 2026-02-06 15:11:43 +11:00
theonejvo 04c99aafc2 chore: remove debug console.log 2026-02-06 15:09:08 +11:00
theonejvo ee81325cb3 feat: VT Code Insight visibility matrix for malicious/suspicious skills
- Malicious skills: visible for transparency, downloads blocked via moderationFlags
- Suspicious skills: visible with warning banner, downloads allowed
- Neither appears in search/listings (not indexed)
- Add isSuspicious flag to moderation info
- Update approveSkillByHashInternal to set moderationFlags properly
- Add warning banner CSS variant for suspicious skills
2026-02-06 15:08:52 +11:00
theonejvo bdc6348b1a fix: show verdict labels (Benign/Suspicious/Malicious) instead of engine stats 2026-02-06 12:52:54 +11:00
theonejvo 68abaa3642 debug: add logging to getBySlug query 2026-02-05 20:36:43 +11:00
theonejvo 0c3acda26e fix: remove unused isModerated variable 2026-02-05 20:27:33 +11:00
theonejvo 650090d298 fix: allow owners to see all moderated skills, not just pending.scan 2026-02-05 20:26:29 +11:00
theonejvo 70220f9487 merge: resolve conflicts with main 2026-02-05 20:12:55 +11:00
theonejvo aad1fbe2c4 fix: use computed badges in pending skill response 2026-02-05 20:08:26 +11:00
theonejvo 2d7914859c feat: show Code Insight analysis for malicious skills
- Add `source` field to VT results to indicate code_insight vs engines
- Display Code Insight analysis text when AI detects malicious patterns
- Only show "X/Y engines" when traditional AV detection triggers
- Add styled analysis block with red accent for malicious verdicts
2026-02-05 19:58:31 +11:00
ba6a99a65f fix: show pending skill page to owners instead of "Skill not found" (#136)
* fix: show pending skill page to owners instead of "Skill not found"

When a skill owner uploads a skill that's pending VirusTotal scan,
they now see their skill page with a pending banner instead of
"Skill not found". The banner explains the scan is in progress.

Changes:
- Modified getBySlug query to return skill data for owners even when
  moderationStatus is 'hidden' with reason 'pending.scan'
- Added pendingReview flag to query response
- Added pending banner component to SkillDetailPage
- Added CSS for pending banner using existing ClawHub gold theme

* fix: show pending skills on owner's dashboard

Extended the list query to include pending skills when the requester
is viewing their own dashboard. Added "Scanning" badge with gold theme
to indicate skills pending VirusTotal review.

* fix: show all moderation states to owners with appropriate UI

- Owners see their blocked/removed skills with explanatory banners
- Red banner for malware-blocked and removed skills
- Gold banner for pending scan
- Download button hidden for blocked/removed skills
- Added security disclaimer: "Like a lobster shell, security has layers"
- Fixed badges bug (use computed badges, not stale skill.badges)

* feat: make malware-blocked skills publicly visible

Blocked skills are now visible to everyone via direct URL:
- Shows red banner with "security issue detected"
- Displays VT scan results
- No download button
- Still hidden from listings/search

Sends a strong transparency signal about security enforcement.

* fix: allow owners to view pending scan skills (#136)

* fix: make deterministic zip date timezone-safe

* chore: update convex api types

* fix: update changelog for pending scan visibility (#136) (thanks @orlyjamie)

---------

Co-authored-by: theonejvo <theonejvo@users.noreply.github.com>
Co-authored-by: Peter Steinberger <steipete@gmail.com>
2026-02-04 23:26:49 -08:00
Peter Steinberger 4ac63c2373 fix: update changelog for pending scan visibility (#136) (thanks @orlyjamie) 2026-02-04 23:25:41 -08:00
Peter Steinberger 8d0f32443a chore: update convex api types 2026-02-04 23:23:13 -08:00
Peter Steinberger 9e75090a39 fix: make deterministic zip date timezone-safe 2026-02-04 23:19:58 -08:00
Peter Steinberger 5cff71104c fix: allow owners to view pending scan skills (#136) 2026-02-04 23:19:53 -08:00
theonejvo 5ef8526874 feat: make malware-blocked skills publicly visible
Blocked skills are now visible to everyone via direct URL:
- Shows red banner with "security issue detected"
- Displays VT scan results
- No download button
- Still hidden from listings/search

Sends a strong transparency signal about security enforcement.
2026-02-05 17:55:29 +11:00
theonejvo 46faafc413 fix: show all moderation states to owners with appropriate UI
- Owners see their blocked/removed skills with explanatory banners
- Red banner for malware-blocked and removed skills
- Gold banner for pending scan
- Download button hidden for blocked/removed skills
- Added security disclaimer: "Like a lobster shell, security has layers"
- Fixed badges bug (use computed badges, not stale skill.badges)
2026-02-05 17:47:04 +11:00
theonejvo 0710b99ac4 fix: show pending skills on owner's dashboard
Extended the list query to include pending skills when the requester
is viewing their own dashboard. Added "Scanning" badge with gold theme
to indicate skills pending VirusTotal review.
2026-02-05 14:51:13 +11:00
theonejvo 9ebe1b6da8 fix: show pending skill page to owners instead of "Skill not found"
When a skill owner uploads a skill that's pending VirusTotal scan,
they now see their skill page with a pending banner instead of
"Skill not found". The banner explains the scan is in progress.

Changes:
- Modified getBySlug query to return skill data for owners even when
  moderationStatus is 'hidden' with reason 'pending.scan'
- Added pendingReview flag to query response
- Added pending banner component to SkillDetailPage
- Added CSS for pending banner using existing ClawHub gold theme
2026-02-05 14:41:00 +11:00
Shakker 98dd49c651 style: fix badges test import formatting
Format import statement to single line per Biome rules.
2026-02-05 03:04:26 +00:00
Shakker a115bb0d65 docs: update changelog for coverage improvements
Add entries for new tests and coverage configuration changes.
2026-02-05 03:04:26 +00:00
Shakker f1625cd5ff chore: add skillZip.ts to coverage tracking
Include convex/lib/skillZip.ts in coverage reports to track
the deterministic ZIP building utility added in PR #130.
2026-02-05 03:04:26 +00:00
Shakker 010ca1677f test: add 4+ errors truncation test for ark schema
Test the formatArkErrors truncation logic when there are more than
3 validation errors, ensuring the "+N more" message is displayed.
2026-02-05 03:04:26 +00:00
Shakker 62d62f976c test: add expandDroppedItems tests for uploadFiles
Add jsdom tests for the expandDroppedItems function:
- Handles null/empty DataTransferItemList
- Collects files via getAsFile fallback
- Collects files via webkitGetAsEntry for file entries
- Recursively collects files from directory entries
- Skips non-file/non-directory entries

Improves branch coverage for uploadFiles.ts.
2026-02-05 03:04:26 +00:00
Shakker 24ad575a4e test: add skillZip module tests
Add tests for the deterministic ZIP building utility from PR #130:
- buildSkillMeta function
- buildDeterministicZip with various scenarios
- Verifies deterministic output and _meta.json inclusion

Achieves 100% coverage for skillZip.ts.
2026-02-05 03:04:26 +00:00
Shakker 1cd6a22284 test: add badges module tests
Add comprehensive tests for the badges utility functions:
- isSkillHighlighted, isSkillOfficial, isSkillDeprecated
- getSkillBadges with all badge combinations

Improves branch coverage from 50% to 100% for badges.ts.
2026-02-05 03:04:26 +00:00
Peter Steinberger 343e065292 fix: stabilize VT scans and UI fetches (#130) (thanks @aleph8) 2026-02-04 17:34:35 -08:00
Alejandro García Peláez 2849a864e0 VirusTotal Integration on ClawHub (#130)
* feat: implementation of dynamic VirusTotal integration and deterministic ZIPs

* fix: do not show security scan results if hash is missing

* ui: show 'Loading...' instead of 'Pending' while fetching VT results

* security: restrict auto-approval to explicit benign verdicts only

* fix: prioritize AI verdict in results and refine stats fallback
2026-02-04 17:33:48 -08:00
Peter Steinberger ae0338e469 feat: add fuzzy user search for moderation CLI 2026-02-04 03:44:54 -08:00
Peter Steinberger ca1ef737cb fix: resolve typecheck errors in api and config 2026-02-04 03:32:09 -08:00
Peter Steinberger 589e46353b fix: management user search and totals 2026-02-04 03:30:07 -08:00
Peter Steinberger 7edbc03494 fix: skill list pagination and footer branding 2026-02-04 03:18:07 -08:00
Peter Steinberger f359071d96 feat(moderation): add set-role 2026-02-02 04:40:53 -08:00
Peter Steinberger 57bae9859e chore(release): 0.5.0 2026-02-02 04:25:11 -08:00
Peter Steinberger 96e9ffdcdc fix(convex): batch hard delete skills 2026-02-02 04:15:22 -08:00
Peter Steinberger eb4601141e fix(cli): honor registry from auth login 2026-02-02 03:25:14 -08:00
Peter Steinberger 39686b3b8d feat(management): add report and user filters 2026-02-02 03:02:52 -08:00
Peter Steinberger a24d3e9809 feat(cli): add inspect and moderation tools 2026-02-02 02:55:56 -08:00
Peter Steinberger 405c74a4ef feat: require report reasons 2026-02-02 00:57:45 -08:00
Peter Steinberger ee828046b8 chore: update dependencies 2026-02-02 00:31:54 -08:00
Peter Steinberger 789082bc00 chore: suppress empty chunk warnings 2026-02-02 00:27:01 -08:00
Peter Steinberger 3e4c2450cd chore: suppress nitro build warnings 2026-02-02 00:25:28 -08:00
Peter Steinberger ea2f51d2ba chore: quiet build warnings 2026-02-02 00:22:04 -08:00
Peter Steinberger 7b2bdbd08f feat: harden moderation and upload safety 2026-02-02 00:17:34 -08:00
Peter Steinberger f654dc9325 fix: allow legacy skill fields in schema 2026-01-31 12:45:35 +01:00
Peter Steinberger d78c105570 feat: add admin user ban 2026-01-31 11:44:31 +01:00
Peter Steinberger a32498ea7d fix: use ClawHub branding for registry 2026-01-31 11:31:46 +01:00
Shadow 5d6ee7adf3 trigger new deploy 2026-01-30 13:05:02 -06:00
Peter Steinberger ffa25f47da chore: rebrand user-facing to OpenClaw 2026-01-30 07:02:35 +01:00
Peter Steinberger f866dc05d1 style: format moderation flags 2026-01-30 05:27:19 +01:00
Peter Steinberger 69436fd79b fix: allow moltbot parsed data 2026-01-30 05:26:09 +01:00
Peter Steinberger f185ca6f55 feat: release 0.4.0 2026-01-30 05:23:12 +01:00
Peter Steinberger f3fc8d62b6 Revert "chore: rename molthub branding"
This reverts commit 8d68b55333.
2026-01-30 05:23:12 +01:00
Shakker 71f94a774f Merge pull request #70 from moltbot/remove-clawd-authenticator-tool
chore(moderation): block ClawdAuthenticatorTool (suspected malware)
2026-01-29 17:18:09 +00:00
vignesh07 07349e6107 chore(moderation): block ClawdAuthenticatorTool listing 2026-01-29 09:14:41 -08:00
Vignesh 5ef00e8c6a chore(security): harden file endpoints CSP + XFO + svg detection (#67) 2026-01-28 23:21:16 -06:00
Jamieson O'Reillyandtheonejvo c5e5e657dd fix: add CSP headers and Content-Disposition to prevent SVG XSS (#61)
Co-authored-by: theonejvo <theonejvo@users.noreply.github.com>
2026-01-28 22:21:39 -06:00
Jamie Turner 69e1e5c507 A few fixes for search. (#64) 2026-01-28 22:21:26 -06:00
Josh Palmer 481f1b9188 Merge pull request #66 from moltbot/fix/ci-lint
fix: restore lint compliance
2026-01-28 21:27:21 +01:00
Josh Palmer d4f5832554 🤖 chore: merge main into fix/ci-lint
- resolve conflicts in search/skill publish files
- apply Biome formatting updates from main

Tests: bun run lint:biome; bun run lint:oxlint
2026-01-28 21:23:50 +01:00
Josh Palmer ca3275ba92 🤖 fix: restore lint compliance
- apply Biome formatting and import ordering across linted files
- fix management useEffect dependencies flagged by Biome

Tests: bun run lint:biome; bun run lint:oxlint
2026-01-28 21:18:19 +01:00
Shadow d577add8a0 fix: unblock convex deploy typecheck 2026-01-28 13:15:18 -06:00
Shadow 90bd065f7e fix: correct public skill entries build 2026-01-28 13:12:41 -06:00
Shadow 219f05b160 fix: sanitize public skill and soul data 2026-01-28 13:03:19 -06:00
Shadow c8091ee8a8 chore: remove unauthenticated badge backfill 2026-01-28 08:33:14 -06:00
Shadow 63f367e1d6 chore: add unauthenticated badge backfill 2026-01-28 08:31:04 -06:00
Shadow e701d7b713 feat: add skill badges table 2026-01-28 01:11:46 -06:00
Shadow 79bd1f1d6c fix: query highlighted skills by batch index 2026-01-28 00:34:33 -06:00
Shadow ac51cc0236 fix: rely on highlighted badge 2026-01-27 23:27:36 -06:00
Shadow b9c23dc00e feat: add reports dashboard for moderation 2026-01-27 22:27:20 -06:00
Shadow f4e96995bc fix: allow clawdis parsed metadata 2026-01-27 21:39:23 -06:00
Shadow 33165db598 feat: unify skill routes with owner slugs 2026-01-27 21:28:46 -06:00
Shadow 4c10e4847b feat: add moderation management and backfill 2026-01-27 21:11:37 -06:00
Shadow 8d68b55333 chore: rename molthub branding 2026-01-27 18:25:02 -06:00
Jamie Turner 251de1f540 Performance optimizations for /skills page 2026-01-27 15:18:21 -06:00
Shadow 123f60fa93 Revert "Performance optimizations for /skills page" temporarily until we can deploy
This reverts commit 643faf71c8.
2026-01-27 12:20:15 -06:00
Jamie Turner 643faf71c8 Performance optimizations for /skills page 2026-01-27 12:09:57 -06:00
Aaron NgandPeter Steinberger a2c46fbb5d Search Fixes (#30)
* more search fixes

* update tests

* comments

* fix: tune search filters and limits (#30) (thanks @aaronn)

---------

Co-authored-by: Peter Steinberger <steipete@gmail.com>
2026-01-25 00:08:29 +00:00
Peter Steinberger f51e0a087d test: fix lockfile mock version 2026-01-24 22:56:39 +00:00
emilianoandPeter Steinberger d9108b0948 feat: show published skills on user profile (#20)
* fix: resolve typecheck and lint errors

* fix: stabilize publish paths and token types

* feat: show published skills on user profile

* fix: document profile published skills (#20) (thanks @njoylab)

---------

Co-authored-by: Peter Steinberger <steipete@gmail.com>
2026-01-24 22:55:18 +00:00
Peter Steinberger d7a017e1c3 fix: add update lookup test (#22) (thanks @daveonkels) 2026-01-24 22:30:09 +00:00
Dave OnkelsandClaude Opus 4.5 fffdf82540 fix: use path instead of url for skill metadata API call (#22)
The `cmdUpdate` function was passing a relative path to `apiRequest`
using the `url` property, but `url` expects a full URL. When `url` is
provided, it's used as-is without combining with the registry base URL.

This caused "Failed to parse URL from /api/v1/skills/<slug>" errors
when updating skills that don't have a local fingerprint match.

Changed to use `path` property which correctly combines with the
registry base URL via `new URL(args.path, registry)`.

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 22:28:54 +00:00
Ahmed Fuad MireClaude Opus 4.5vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>Ahmed
a16e624766 fix: relax search token matching to require at least one match (#27)
* fix: relax search token matching to require at least one match

The search was requiring ALL query tokens to exist in the skill's
displayName, slug, or summary. This was too strict and caused valid
results to be filtered out. For example, searching "HTTP API client"
would fail to match skills about "HTTP API" that didn't mention "client".

Changed from `.every()` to `.some()` so at least one token must match,
allowing the vector similarity to determine relevance for the rest.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: update matchesExactTokens to require prefix matching for query tokens

* more inclusive token check

* Update convex/lib/searchText.ts

Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>

---------

Co-authored-by: Ahmed <ahmed.mire@kaluza.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
2026-01-24 21:23:03 +00:00
Peter Steinberger decce1d35c fix: skip missing skills in search hydration (#28) (thanks @aaronn) 2026-01-24 21:11:46 +00:00
Aaron Ng 468832af3f fix search (#28) 2026-01-24 21:11:06 +00:00
Shadow 54c793a660 fix: handle search embedding errors 2026-01-23 15:48:53 -06:00
Shadow 5d9a89a885 fix search 2026-01-23 15:24:26 -06:00
Peter Steinberger 31e9a57678 feat: add installs/trending sorts 2026-01-19 07:06:46 +00:00
Peter Steinberger 7680cc4ce8 feat: add idempotent star endpoints 2026-01-19 03:09:27 +00:00
Peter Steinberger de56255b95 fix: normalize monaco surface color 2026-01-19 02:21:51 +00:00
Peter Steinberger eaaa5e4423 Merge pull request #12 from NACC96/fix/search-mode-navigation
fix: search mode navigation and state management
2026-01-18 23:54:17 +00:00
Peter Steinberger 49e9c3c071 fix: stabilize search mode routing (#12) (thanks @NACC96) 2026-01-18 23:53:42 +00:00
NACC96 ef96fbee84 fix: auto-focus search input when search mode activates 2026-01-18 23:51:49 +00:00
NACC96 9fc032216e fix: update Header search links to use URL params instead of /search redirect 2026-01-18 23:51:49 +00:00
NACC96 236058b1b5 fix: preserve search flag in OnlyCrabsHome URL sync 2026-01-18 23:51:49 +00:00
NACC96 595bd2cf05 fix: search mode navigation and state management
- Fix "Explore search" button causing page refresh by using URL params
- Enable /search URL deep linking via beforeLoad redirect
- Fix logo click not closing search mode by properly syncing state with URL
2026-01-18 23:51:49 +00:00
Peter Steinberger 918b5528df chore: format peer check script 2026-01-18 23:42:04 +00:00
Peter Steinberger 2f6f11af3f ci: add peer dependency check 2026-01-18 23:40:55 +00:00
Peter Steinberger c90f92dbc7 fix: align auth core with convex auth 2026-01-18 23:33:51 +00:00
Peter Steinberger 8db8c89206 chore: update deps and adjust vite convex resolution 2026-01-18 23:29:59 +00:00
Peter Steinberger 00c31dcdd4 fix: derive auth from user query 2026-01-18 23:13:29 +00:00
Peter Steinberger 47646937b6 fix: dedupe convex auth modules 2026-01-18 22:33:09 +00:00
Shadow 10d250ea32 fix: keep ConvexAuthProvider during SSR 2026-01-18 14:43:24 -06:00
Peter Steinberger e7fa7afdf7 chore: bump clawdhub to 0.2.1 2026-01-18 16:28:40 +00:00
Peter Steinberger aa97727be8 fix: harden explore limit + tests/docs (#14) (thanks @jdrhyne) 2026-01-18 16:26:28 +00:00
Peter Steinberger d375496c17 Merge pull request #14 from jdrhyne/feat/explore-command
feat(cli): add explore command to browse latest updated skills
2026-01-18 16:25:48 +00:00
Peter Steinberger 9a912ee5eb chore: update dependencies 2026-01-18 14:10:09 +00:00
Peter Steinberger 11b257a062 fix: harden search and cli http 2026-01-18 14:04:35 +00:00
Peter Steinberger 02e509404a chore: update convex api types 2026-01-18 09:12:52 +00:00
Peter Steinberger 2cf6182991 fix: tighten search matching 2026-01-18 09:11:16 +00:00
Jonathan Rhyne e108789ab1 feat(cli): add explore command to browse latest updated skills
Adds a new `clawdhub explore` command that fetches the most recently
updated skills from the registry, sorted by updatedAt descending.

Usage:
  clawdhub explore           # Show latest 25 skills
  clawdhub explore --limit 10

Output includes slug, version, relative time since update, and summary.

The API endpoint already exists and returns skills sorted by updatedAt,
this just exposes it via the CLI.
2026-01-17 23:07:54 -05:00
Peter Steinberger 18bfea5035 fix: enable explore search button 2026-01-17 21:54:29 +00:00
Peter Steinberger 5f93ddb390 fix: rename ClawdBot to Clawdbot 2026-01-16 01:14:24 +00:00
Peter Steinberger 2b552c4803 feat: default workdir from clawdbot config 2026-01-13 06:04:38 +00:00
Peter Steinberger ece0b830fb test: raise branch coverage 2026-01-13 01:25:06 +00:00
Peter Steinberger 57afea9de5 chore: ignore test-results in biome 2026-01-13 01:24:56 +00:00
Peter Steinberger 1e788b2e0c test: add playwright smoke suite 2026-01-13 00:46:13 +00:00
Peter Steinberger f025721261 fix: prevent skills index crash 2026-01-13 00:40:04 +00:00
Shadow c2cc61df24 feat: add skills lazy loading 2026-01-12 15:52:52 -06:00
Shadow 7a8a3f75ce fix: paginate skills index 2026-01-12 13:36:28 -06:00
Peter Steinberger ac0bdf0375 fix: hide onlycrabs branding 2026-01-11 05:20:20 +01:00
Peter Steinberger 6c7dd2ec6d fix: hide onlycrabs link and code pill 2026-01-11 05:15:43 +01:00
Peter Steinberger c72e3007a1 test: guard skills list query limit 2026-01-10 22:04:42 +01:00
Peter Steinberger b66d28a184 fix: lower skills list query limit 2026-01-10 22:01:06 +01:00
Shadow dddee828af Change ClawdBot link to new URL 2026-01-10 14:01:27 -06:00
Peter Steinberger 106cb1896a Merge pull request #1 from clawdbot/nix-plugin-metadata
Add nix-clawdbot plugin pointers to skill metadata
2026-01-10 19:33:11 +00:00
Peter Steinberger e29ec88afd fix: restore backups + fork lineage (#1) (thanks @joshp123) 2026-01-10 20:32:47 +01:00
Josh Palmer 0eb3047ca6 feat: add nix plugin bundles
- include nix plugin metadata, config requirements, and CLI help
- add config examples and format bundle code blocks
- refresh bundle UI styling and layout
2026-01-10 20:27:22 +01:00
Peter Steinberger b34c7261bd feat: add v1 public api 2026-01-10 20:25:50 +01:00
DB Hurley e0d553602a feat: refresh skill detail layout and dashboard
- add dashboard with skill management and upload prefill
- redesign skill detail layout with full-width panels
- refactor modules and format dashboard/upload routes
2026-01-10 20:23:01 +01:00
Peter Steinberger f80fa90e01 fix(seed): harden SoulHub auto-seed 2026-01-10 20:18:19 +01:00
Josh Palmer 0cc0bdcd50 feat: SoulHub registry + auto-seed
SoulHub SOUL.md registry (souls table, versions, search, OG) + first-run auto-seed; fixes seed concurrency and GitHub backup owner handle.
2026-01-10 18:25:11 +00:00
Peter Steinberger cc0027a094 test(og): update OG layout version 2026-01-09 19:16:39 +01:00
Peter Steinberger dddbd3a78e fix(og): prevent OG title clipping 2026-01-09 19:13:19 +01:00
Peter Steinberger f350442002 feat: import skills from public GitHub 2026-01-09 09:10:49 +01:00
Peter Steinberger 826c60f4da test(cli): expand clawdbot sync coverage 2026-01-09 02:34:09 +01:00
Peter Steinberger a679c3a999 docs: note clawdbot sync roots 2026-01-09 02:05:34 +01:00
Peter Steinberger d5d8e6ae5b feat(cli): auto-scan clawdbot skill roots 2026-01-09 01:57:56 +01:00
Peter Steinberger f0772e7215 test: cover OG text clamping 2026-01-08 23:07:10 +01:00
Peter Steinberger 770bb3aeb8 fix: clamp OG description width 2026-01-08 23:02:33 +01:00
Peter Steinberger 6811691055 fix: prevent OG text bleed 2026-01-08 22:58:53 +01:00
Peter Steinberger 26b46d9f6e docs: note OG image runtime fix 2026-01-08 06:15:09 +01:00
Peter Steinberger d145c186a7 fix: resolve OG api base on all runtimes 2026-01-08 06:12:01 +01:00
Peter Steinberger 57af81d054 refactor: modularize skill OG images 2026-01-08 06:07:36 +01:00
Peter Steinberger 0131229843 fix: embed fonts in OG images 2026-01-08 05:54:49 +01:00
Peter Steinberger d7650583dc feat: dynamic skill OG images 2026-01-08 05:47:27 +01:00
Peter Steinberger cf2ad58e86 chore: remove docs page link 2026-01-08 04:20:25 +01:00
Peter Steinberger 153c3f5b9e style: soften markdown block styling 2026-01-07 22:41:57 +01:00
Peter Steinberger 243ca9ca2b feat: link docs and clarify cli usage 2026-01-07 21:11:04 +01:00
Peter Steinberger 8216c73c9b test: stabilize upload route mocks 2026-01-07 20:18:32 +01:00
Peter Steinberger 860902a574 fix: harden upload utils 2026-01-07 20:14:18 +01:00
Peter Steinberger 18af63b630 fix: silence lint/build warnings 2026-01-07 20:08:13 +01:00
Peter Steinberger 96ac7567ba chore: prepare 0.1.0 release notes 2026-01-07 20:07:06 +01:00
Peter Steinberger b55e266457 fix: harden GitHub backups 2026-01-07 18:48:09 +00:00
Shadowandvercel[bot] <35613825+vercel[bot]@users.noreply.github.com> 2492a52ca3 Update skillPublish.ts
Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
2026-01-07 18:48:09 +00:00
Shadow 9b6a4c7b6f chore: format lint fixes 2026-01-07 18:48:09 +00:00
Shadow 232d06debd fix: preserve previous commit in github history 2026-01-07 18:48:09 +00:00
Shadow e6ba699b18 feat: back up skills to github 2026-01-07 18:48:09 +00:00
Peter Steinberger 7444c22d57 chore: bump cli version to 0.1.0 2026-01-07 19:13:00 +01:00
Peter Steinberger cf26cd143a fix: address deploy typecheck 2026-01-07 18:49:49 +01:00
Peter Steinberger 82b426cc8e fix: harden multipart publish parsing 2026-01-07 18:42:44 +01:00
Peter Steinberger ba7e82ba02 feat: add v1 public api 2026-01-07 18:28:51 +01:00
Peter Steinberger 9f83114dee chore: add docs:list helper 2026-01-07 17:58:00 +01:00
Peter Steinberger a98b51a2a1 test: fix upload route mocks 2026-01-07 17:53:01 +01:00
Peter Steinberger 4d6987097d style: format dashboard and upload routes 2026-01-07 17:52:57 +01:00
Peter Steinberger 1bf3bcf152 docs: add Mintlify-ready docs set 2026-01-07 17:52:55 +01:00
Peter Steinberger 974338fb97 docs: thank dbhurley for dashboard 2026-01-07 10:08:20 +01:00
Peter Steinberger 927cd4d425 Merge pull request #2 from dbhurley/feat/user-dashboard
feat: Add user dashboard with skill management
2026-01-07 09:07:42 +00:00
Peter Steinberger bfa59cabf5 merge main into feat/user-dashboard 2026-01-07 10:06:14 +01:00
Peter Steinberger 2a28f75fc6 docs: thank dbhurley in changelog 2026-01-07 09:50:31 +01:00
Peter Steinberger fff263ee68 Merge pull request #4 from dbhurley/fix/token-color-error
fix: handle shorthand hex colors in SkillDiffCard
2026-01-07 08:50:02 +00:00
Peter Steinberger af40c53bc1 style: pad diff file list 2026-01-07 07:52:37 +01:00
Peter Steinberger 74a0ca9bf6 style: remove diff hover lift 2026-01-07 07:42:10 +01:00
Peter Steinberger 3f85eccd1a refactor: make skill detail full width 2026-01-07 07:17:14 +01:00
Peter Steinberger 9513bd9f44 style: remove divider before versions 2026-01-07 07:04:55 +01:00
Peter Steinberger 27958bbb69 fix: type skill origin in tests 2026-01-07 06:18:41 +01:00
Peter Steinberger 7a62bec162 style: format skill tests 2026-01-07 06:16:21 +01:00
Peter Steinberger e895840411 test: cover skill utilities 2026-01-07 06:13:42 +01:00
Peter Steinberger 9c574a7709 feat: redesign skill detail layout 2026-01-07 05:56:12 +01:00
Peter Steinberger 6af5cf11ec docs: note Convex run --env-file auth gotcha 2026-01-07 05:50:42 +01:00
Peter Steinberger 237a965673 feat: dedupe skills via canonical forks 2026-01-07 05:20:19 +01:00
DB Hurley 219e3257ec fix: normalize hex colors in SkillDiffCard to prevent Monaco crash 2026-01-06 21:44:36 -05:00
Peter Steinberger 5e1598954f feat: add Vercel Analytics 2026-01-07 03:23:12 +01:00
Peter Steinberger 0a059e337f style: align version rows 2026-01-07 02:21:13 +01:00
Peter Steinberger 3d24969f1e style: refine comment form sizing 2026-01-07 02:20:00 +01:00
Peter Steinberger cc530d8a69 test: raise coverage for diffing 2026-01-07 01:46:03 +01:00
Peter Steinberger 6049863b8f feat: add skill diff viewer 2026-01-06 23:29:03 +01:00
Peter Steinberger 76ad34eb89 chore: release 0.0.5 2026-01-06 17:29:28 +01:00
Peter Steinberger 6be9f93eeb refactor: split large modules 2026-01-06 17:24:17 +01:00
Peter Steinberger 1f0d02019b fix: yaml frontmatter + summary backfill 2026-01-06 05:19:00 +01:00
Peter Steinberger 7ef25343ec docs: update changelog 2026-01-06 04:20:35 +01:00
Peter Steinberger 5365827416 fix: ignore plural skills.md markers 2026-01-06 04:03:54 +01:00
Peter Steinberger baee5aee2e fix: show wordmark on mobile 2026-01-06 03:07:36 +01:00
Peter Steinberger 1eebbd4c2d chore: log webhook sends 2026-01-06 02:53:08 +01:00
Peter Steinberger f9ea6ab355 feat: improve Open Graph preview 2026-01-06 02:46:47 +01:00
Peter Steinberger dfe6150474 feat: move theme picker into mobile menu 2026-01-06 02:03:43 +01:00
Peter Steinberger 860b3a369c feat: track installs via sync telemetry 2026-01-06 01:38:49 +01:00
Peter Steinberger 7eb8286f4c feat: add discord webhooks 2026-01-06 00:53:58 +01:00
Peter Steinberger 721dcea079 fix(web): improve mobile responsiveness 2026-01-06 00:26:32 +01:00
Peter Steinberger d067f8f5ed feat: auto-generate changelogs 2026-01-06 00:16:36 +01:00
Peter Steinberger 9a216acb4c fix: add skill og cards 2026-01-05 23:43:20 +01:00
DB Hurley d4b947af47 feat: Add user dashboard with skill management
- Add /dashboard route showing user's published skills
- Add 'Dashboard' link to user dropdown menu in header
- Skills display name, slug, description, stats (downloads, stars, versions)
- 'New Version' button links to upload with pre-populated slug
- Upload route accepts ?updateSlug param to pre-fill form for updates
- Auto-bumps version number when updating existing skill
- Responsive design for mobile
- Empty state with call-to-action for new users
2026-01-05 17:34:54 -05:00
Peter Steinberger bf1a2d6966 chore: release 0.0.4 2026-01-05 23:28:14 +01:00
Peter Steinberger 17ecc9d648 fix: reduce embedding payload size 2026-01-05 23:13:59 +01:00
Peter Steinberger 9f1e003401 fix: prefer discovered registry 2026-01-05 22:52:41 +01:00
Peter Steinberger 709f2f30de fix: cap embedding input size 2026-01-05 22:03:31 +01:00
Peter Steinberger 79c3baec13 docs(web): fix ClawdBot casing 2026-01-05 21:53:33 +01:00
Peter Steinberger ab1e3f0185 docs(web): adjust footer copy 2026-01-05 21:51:41 +01:00
Peter Steinberger 1d030b9c78 fix(cli): make bin executable 2026-01-05 21:50:30 +01:00
Peter Steinberger 9f4d111892 style(web): soften footer 2026-01-05 18:48:09 +01:00
Peter Steinberger bebee5e124 feat(web): add global footer + see-all 2026-01-05 18:42:08 +01:00
Peter Steinberger e8653dc793 fix(web): smooth hero search transition 2026-01-05 06:37:31 +01:00
Peter Steinberger d8dd6542ca docs: rewrite README 2026-01-05 05:51:16 +01:00
Peter Steinberger 2303457da6 test(web): cover skill detail loading 2026-01-05 04:47:05 +01:00
Peter Steinberger d7862a8d35 docs(changelog): note folder upload unwrap 2026-01-05 04:40:09 +01:00
Peter Steinberger c91b7069d8 fix(web): accept folder uploads with SKILL.md 2026-01-05 04:39:52 +01:00
Peter Steinberger 73ae10b023 feat(web): canonical skill urls 2026-01-05 04:22:37 +01:00
Peter Steinberger d32fb65207 feat(web): admin highlight toggle 2026-01-05 04:14:05 +01:00
Peter Steinberger d6efc003e1 fix(web): user profile avatar + loading 2026-01-05 04:10:59 +01:00
Peter Steinberger e767392fd6 fix(web): show loading state on skills list 2026-01-05 04:08:22 +01:00
Peter Steinberger 47603e4ff3 feat(web): add skills list + sorting 2026-01-05 04:06:52 +01:00
Peter Steinberger 8ece7713ed fix(web): avoid skill not found flash 2026-01-05 03:56:34 +01:00
Peter Steinberger 3c31b460ff fix(web): keep search request id simple 2026-01-05 03:42:46 +01:00
Peter Steinberger 554d5d4cd0 feat: unify homepage search 2026-01-05 03:37:16 +01:00
Peter Steinberger 236c670015 fix(cli): unbox sync output 2026-01-05 01:59:39 +01:00
Peter Steinberger e617345233 docs: update 0.0.3 changelog 2026-01-05 01:49:55 +01:00
Peter Steinberger e0528139b3 docs(changelog): add 0.0.4 entries 2026-01-05 01:49:15 +01:00
Peter Steinberger 99de234c1e feat: add install command switcher 2026-01-05 01:48:44 +01:00
Peter Steinberger 8f97dc08d9 test: fix sync test typing 2026-01-05 01:48:36 +01:00
Peter Steinberger ed0e15c572 perf(cli): default sync concurrency to 4 2026-01-05 01:44:25 +01:00
Peter Steinberger 2f0f1b6df7 chore: release 0.0.3 2026-01-04 19:32:49 +01:00
Peter Steinberger a096aaa026 feat: improve sync UX and bundle schema 2026-01-04 19:31:53 +01:00
Peter Steinberger 0514a9b57f feat: refine home skill cards 2026-01-04 19:31:19 +01:00
Peter Steinberger 541f96cbbf chore: release 0.0.2 2026-01-04 18:16:44 +01:00
Peter Steinberger 3af9cdfc0c fix: dedupe sync list and add tests 2026-01-04 17:57:40 +01:00
Peter Steinberger b974bc7c0b fix: add parsing progress for sync 2026-01-04 17:47:59 +01:00
Peter Steinberger 91233dfe57 fix: improve sync selection output 2026-01-04 17:30:03 +01:00
Peter Steinberger 2a2749f852 fix: improve zip upload handling 2026-01-04 16:45:56 +01:00
Peter Steinberger 56230aa329 test: expand cli coverage
- add e2e coverage for install/update + --cli-version
- add unit coverage for sync optional changelog
- add handler tests for delete/undelete
2026-01-04 15:55:49 +01:00
Peter Steinberger b93bb5830b feat(clawdhub): soft delete skills
- make changelog optional for publish/sync
- add CLI delete/undelete + API routes
- hide deleted skills from search/download
- add e2e + manual testing doc + changelog
2026-01-04 15:50:09 +01:00
Peter Steinberger 6d1a376515 fix(clawdhub): normalize bin path for npm 2026-01-04 14:54:15 +01:00
Peter Steinberger 62fe5954b0 chore: rename schema package for npm 2026-01-04 14:50:11 +01:00
Peter Steinberger 41dd6de0e1 fix(clawdhub): default to sync and robust resolve check 2026-01-04 13:07:22 +01:00
Peter Steinberger 2c04427f67 chore: remove jan4 refactor checklist 2026-01-04 07:55:25 +01:00
Peter Steinberger 64569284e9 docs: check off CI 2026-01-04 07:55:17 +01:00
Peter Steinberger 1ab9c35f15 docs: check off gate 2026-01-04 07:53:33 +01:00
Peter Steinberger 292c2ecbb9 chore: format sync test 2026-01-04 07:53:21 +01:00
Peter Steinberger cf70a8f961 docs(clawdhub): clarify auth + sync usage 2026-01-04 07:52:18 +01:00
Peter Steinberger 410d2e04f7 test(clawdhub): cover sync status classification 2026-01-04 07:51:08 +01:00
Peter Steinberger 4965ff6f1f docs: check off clawdbot roots 2026-01-04 07:48:08 +01:00
Peter Steinberger 11315a83c2 feat(clawdhub): detect clawdbot skill roots 2026-01-04 07:47:55 +01:00
Peter Steinberger 0f0e955479 docs: jan4 refactor checklist 2026-01-04 07:47:04 +01:00
Peter Steinberger 0103c00a72 feat(clawdhub): add local skills sync 2026-01-04 07:41:12 +01:00
Peter Steinberger de907c9dbe test: add opt-in e2e suite 2026-01-04 07:28:47 +01:00
Peter Steinberger 5d96853cff fix(schema): allow multiple search results 2026-01-04 07:22:41 +01:00
Peter Steinberger ceeb1162ca feat(clawdhub): colorized help with build label 2026-01-04 07:20:33 +01:00
Peter Steinberger 5e86028356 fix(test): make publish smoke test typecheck 2026-01-04 07:15:17 +01:00
Peter Steinberger 4867d3389d test(clawdhub): add publish smoke test 2026-01-04 07:13:35 +01:00
Peter Steinberger 5108072523 chore: remove jan4 refactor checklist 2026-01-04 07:08:09 +01:00
Peter Steinberger b61c0c240e docs: complete jan4 checklist 2026-01-04 07:06:58 +01:00
Peter Steinberger ff6f2f6b36 fix: restore @auth/core for Convex auth 2026-01-04 07:04:58 +01:00
Peter Steinberger c25bd0808d chore: update dependencies 2026-01-04 06:57:30 +01:00
Peter Steinberger 0460d03780 docs: note npm name availability 2026-01-04 06:53:24 +01:00
Peter Steinberger 3ddbac35f3 feat: proxy /api to Convex 2026-01-04 06:51:49 +01:00
Peter Steinberger 6b4e0f6c0f refactor(clawdhub): split CLI modules 2026-01-04 06:48:56 +01:00
Peter Steinberger e2e3e792b5 chore(schema): update dist 2026-01-04 06:35:08 +01:00
Peter Steinberger f671b886ce refactor(clawdhub): centralize registry resolution 2026-01-04 06:35:03 +01:00
Peter Steinberger 690413fb60 chore(schema): update dist 2026-01-04 06:31:48 +01:00
Peter Steinberger c9869901d0 feat: well-known v1 config 2026-01-04 06:31:41 +01:00
Peter Steinberger 827205a21e fix(auth): add state nonce 2026-01-04 06:29:33 +01:00
Peter Steinberger 51fe501601 fix: move route tests out of routes 2026-01-04 06:26:40 +01:00
Peter Steinberger 54d7fc0f2b docs: add jan4 refactor checklist 2026-01-04 06:22:58 +01:00
Peter Steinberger 21941b5a08 docs(clawdhub): describe registry discovery 2026-01-04 06:18:30 +01:00
Peter Steinberger e3de833359 fix(clawdhub): registry discovery + label b64 2026-01-04 06:16:09 +01:00
Peter Steinberger 7829eb13de chore(schema): update dist 2026-01-04 06:16:03 +01:00
Peter Steinberger c6cfc4feb5 feat(schema): add well-known registry config 2026-01-04 06:11:46 +01:00
Peter Steinberger 3a175f4d33 chore(docs): remove jan4 refactor checklist 2026-01-04 06:01:37 +01:00
Peter Steinberger a0133cd6c9 fix(clawdhub): stabilize browser login 2026-01-04 06:01:17 +01:00
Peter Steinberger fb60071c13 chore: dependency audit 2026-01-04 05:58:31 +01:00
Peter Steinberger 57ef9ace63 feat(clawdhub): browser auth login 2026-01-04 05:57:17 +01:00
Peter Steinberger b42573cd3e chore: improve bun clawdhub runner 2026-01-04 05:55:26 +01:00
Peter Steinberger 809119c99a docs: add jan4 refactor checklist 2026-01-04 05:55:01 +01:00
Peter Steinberger b85ba642a5 chore: add bun shortcut runner 2026-01-04 05:31:55 +01:00
Peter Steinberger a4f8e30b7d feat(clawdhub): add auth subcommands 2026-01-04 05:01:30 +01:00
Peter Steinberger 2e558271a2 fix(upload): stabilize file hashing 2026-01-04 04:26:33 +01:00
Peter Steinberger 4baf9d2554 chore(schema): track dist artifacts 2026-01-04 04:24:39 +01:00
Peter Steinberger 8bbecd15f8 chore(docs): remove jan4 refactor checklist 2026-01-04 04:21:49 +01:00
Peter Steinberger e6cb9467c6 fix(clawdhub): typecheck update meta lookup 2026-01-04 04:21:18 +01:00
Peter Steinberger cebf50a842 ci: add GitHub Actions 2026-01-04 04:19:02 +01:00
Peter Steinberger 0c7caf01bf test: cover theme transition 2026-01-04 04:18:40 +01:00
Peter Steinberger b3b558d700 chore: remove unused deps 2026-01-04 04:17:00 +01:00
Peter Steinberger 78bbed1d78 feat(clawdhub): improve publish file collection 2026-01-04 04:15:47 +01:00
Peter Steinberger e7ad1f2e94 refactor(schema): centralize API routes 2026-01-04 04:13:28 +01:00
Peter Steinberger ed8cc656ab refactor(schema): share text file helpers 2026-01-04 04:11:25 +01:00
Peter Steinberger 794ee23c03 chore: prep schema package for publishing
- switch schema deps to semver

- publishConfig + prepublishOnly

- update jan4 checklist
2026-01-04 04:05:43 +01:00
Peter Steinberger d227986dde docs: add jan4 refactor checklist 2026-01-04 04:04:03 +01:00
Peter Steinberger 1f47d000f8 feat(ui): icon theme toggle animation 2026-01-04 04:02:05 +01:00
Peter Steinberger 0cd1a73870 feat(clawdhub): add prompts and retries 2026-01-04 04:01:59 +01:00
Peter Steinberger 5c28a2a252 refactor: extract @clawdhub/schema package
- Move ArkType schemas into packages/schema

- Wire app/convex/cli imports to workspace dep

- Add workspaces + update lint/coverage

- Build schema dist (tracked)
2026-01-04 03:49:57 +01:00
Peter Steinberger 586a08ed4d feat: share runtime schemas with arktype
- Add shared ArkType schemas for CLI+HTTP

- Validate CLI requests/responses + lockfile/config

- Add /api/skill/resolve endpoint + tests

- Keep lint + coverage gates green
2026-01-04 03:38:33 +01:00
Peter Steinberger 2b78e7fe7c fix: harden CLI HTTP API handlers
- Fix /api/search param (approvedOnly)

- Add handler helpers for unit tests

- Add coverage gate (>=70%) + more tests

- Expand type-aware oxlint scope to CLI
2026-01-04 03:03:58 +01:00
Peter Steinberger 2be43c04aa style(markdown): wrap long code lines 2026-01-04 02:47:41 +01:00
Peter Steinberger fe759a574e style(skill): replace star button 2026-01-04 02:43:05 +01:00
Peter Steinberger c2a1ce7e8b feat(skills): add metadata sidebar 2026-01-04 02:41:25 +01:00
Peter Steinberger 0b8c0676d6 style(theme): deepen dark accents 2026-01-04 02:34:38 +01:00
Peter Steinberger c190aec76f chore(copy): swap approval for highlight 2026-01-04 02:33:30 +01:00
Peter Steinberger c745f45e45 feat(search): add highlight filter 2026-01-04 02:33:06 +01:00
Peter Steinberger 1cd4a02af6 chore(copy): simplify search title 2026-01-04 02:27:56 +01:00
Peter Steinberger 8728b6759b style(search): upgrade filter toggle 2026-01-04 02:27:15 +01:00
Peter Steinberger c891fc984b style(cli): wrap long lines 2026-01-04 02:25:04 +01:00
Peter Steinberger 6169c87cdc fix(upload): use dropzone button 2026-01-04 02:24:44 +01:00
Peter Steinberger 1020c5ae3a style: wrap api and cli lines 2026-01-04 02:21:50 +01:00
Peter Steinberger 0c2da9fdd2 style(ui): normalize imports 2026-01-04 02:21:40 +01:00
Peter Steinberger ab1cb6b48f feat(settings): add api token management 2026-01-04 02:21:27 +01:00
Peter Steinberger 6c4d62777e chore: update generated types 2026-01-04 02:18:21 +01:00
Peter Steinberger d104bed8fb feat(cli): add registry client 2026-01-04 02:17:45 +01:00
Peter Steinberger 7dcd243275 feat(api): add cli token auth 2026-01-04 02:17:33 +01:00
Peter Steinberger f4036351a8 chore(copy): streamline home stats 2026-01-04 02:17:21 +01:00
Peter Steinberger 5babca05f0 feat(settings): upgrade profile card 2026-01-04 02:17:13 +01:00
Peter Steinberger 660e59742b fix(convex): require changelog on updates 2026-01-04 02:08:24 +01:00
Peter Steinberger a89a46a1cc fix(upload): gate validation feedback 2026-01-04 02:08:14 +01:00
Peter Steinberger e1022fdef3 feat(brand): use clawd logo 2026-01-04 01:59:04 +01:00
Peter Steinberger e95ccacfa0 fix(upload): show convex error details 2026-01-03 23:32:20 +01:00
Peter Steinberger 1b5a5a8d35 chore(dev): add convex deploy shortcut 2026-01-03 22:53:55 +01:00
Peter Steinberger caa94f0ba6 fix(types): align file buffers for convex deploy 2026-01-03 22:53:44 +01:00
Peter Steinberger e638154f64 fix(convex): surface publish errors 2026-01-03 22:38:26 +01:00
Peter Steinberger 1151e92a47 chore(assets): update favicon 2026-01-03 22:35:24 +01:00
Peter Steinberger 303fce970e feat(ui): adopt shadcn primitives 2026-01-03 22:35:15 +01:00
Peter Steinberger aaab5d53bc chore(deps): add radix ui primitives 2026-01-03 22:34:58 +01:00
Peter Steinberger 84cae81864 chore(deps): update dependencies 2026-01-03 22:24:17 +01:00
Peter Steinberger 90d6b50662 fix(upload): clean errors and remove badge 2026-01-03 22:24:00 +01:00
Peter Steinberger 320f431f2d feat(theme): add mode toggle and user menu 2026-01-03 22:23:39 +01:00
Peter Steinberger da636b20d1 fix(upload): handle publish errors and redirect 2026-01-03 22:09:28 +01:00
Peter Steinberger 4abb5181bb feat(upload): add archive extraction and form polish 2026-01-03 22:02:39 +01:00
Peter Steinberger 63d94a06a7 docs: add repository guidelines 2026-01-03 19:38:18 +01:00
Peter Steinberger 2eeeb9a433 chore: commit convex generated api 2026-01-03 19:28:00 +01:00
Peter Steinberger 10634d1789 fix: resolve typecheck errors 2026-01-03 18:45:37 +01:00
Peter Steinberger 30640a10c8 fix: resolve type lint issues 2026-01-03 18:33:18 +01:00
Peter Steinberger 05a2604cb6 style: apply biome formatting 2026-01-03 18:23:30 +01:00
Peter Steinberger b78ed1e242 chore: fix lint and typings 2026-01-03 18:23:01 +01:00
Peter Steinberger c5a40d6d09 chore: clean repo leftovers 2026-01-03 18:17:42 +01:00
Peter Steinberger 746905d7b9 fix: align auth core version 2026-01-03 18:15:49 +01:00
Peter Steinberger 0533b780be fix: correct user profile route filename 2026-01-03 18:14:54 +01:00
Peter Steinberger 8df19780ea feat: bootstrap clawdhub 2026-01-03 18:14:33 +01:00
Peter Steinberger fa4859bc88 Initial commit 2026-01-03 14:49:41 +01:00
904 changed files with 46013 additions and 6406 deletions
+19
View File
@@ -0,0 +1,19 @@
# Frontend
VITE_CONVEX_URL=
VITE_CONVEX_SITE_URL=
VITE_SOULHUB_SITE_URL=
VITE_SOULHUB_HOST=
VITE_SITE_MODE=
SITE_URL=http://localhost:3000
CONVEX_SITE_URL=
# Convex Auth (GitHub OAuth App)
AUTH_GITHUB_ID=
AUTH_GITHUB_SECRET=
# Convex Auth JWT keys (generated via @convex-dev/auth CLI)
JWT_PRIVATE_KEY=
JWKS=
# Embeddings
OPENAI_API_KEY=
+40
View File
@@ -0,0 +1,40 @@
name: CI
on:
push:
branches: [main]
pull_request:
jobs:
build:
runs-on: ubuntu-latest
timeout-minutes: 15
steps:
- uses: actions/checkout@v4
- uses: oven-sh/setup-bun@v2
with:
bun-version: 1.3.6
- name: Install
run: bun install --frozen-lockfile
- name: Peer deps
run: bun run check:peers
- name: Lint
run: bun run lint
- name: Test
run: bun run test
- name: Coverage
run: bun run coverage
- name: Typecheck packages
run: |
bunx tsc -p packages/schema/tsconfig.json --noEmit
bunx tsc -p packages/clawdhub/tsconfig.json --noEmit
- name: Build
run: bun run build
+26
View File
@@ -0,0 +1,26 @@
node_modules
.DS_Store
.bun-build
*.bun-build
bin/docs-list
dist
dist-ssr
!packages/schema/dist
!packages/schema/dist/**
*.local
.vercel
count.txt
.env
.nitro
.tanstack
.wrangler
.output
.vinxi
todos.json
.cta.json
.vscode
.env*.local
coverage
playwright-report
test-results
.playwright
+3
View File
@@ -0,0 +1,3 @@
{
"ignorePatterns": ["node_modules", "dist", "coverage", "convex/_generated", ".tanstack", "public"]
}
+45
View File
@@ -0,0 +1,45 @@
# Repository Guidelines
## Project Structure & Module Organization
- `src/` — TanStack Start app code (routes, components, styles).
- `convex/` — Convex backend (schema, queries/mutations/actions, HTTP routes).
- `convex/_generated/` — generated Convex API/types; committed for builds.
- `docs/` — product/spec docs (see `docs/spec.md`).
- `public/` — static assets.
## Build, Test, and Development Commands
- `bun run dev` — local app server at `http://localhost:3000`.
- `bun run build` — production build (Vite + Nitro).
- `bun run preview` — preview built app.
- `bunx convex dev` — Convex dev deployment + function watcher.
- `bunx convex codegen` — regenerate `convex/_generated`.
- `bun run lint` — Biome + oxlint (type-aware).
- `bun run test` — Vitest (unit tests).
- `bun run coverage` — coverage run; keep global >= 80%.
## Coding Style & Naming Conventions
- TypeScript strict; ESM.
- Indentation: 2 spaces, single quotes (Biome).
- Lint/format: Biome + oxlint (type-aware).
- Convex function names: verb-first (`getBySlug`, `publishVersion`).
## Testing Guidelines
- Framework: Vitest 4 + jsdom.
- Tests live in `src/**` and `convex/lib/**`.
- Coverage threshold: 80% global (lines/functions/branches/statements).
- Example: `convex/lib/skills.test.ts`.
## Commit & Pull Request Guidelines
- Commit messages: Conventional Commits (`feat:`, `fix:`, `chore:`, `docs:`…).
- Keep changes scoped; avoid repo-wide search/replace.
- PRs: include summary + test commands run. Add screenshots for UI changes.
## Configuration & Security
- Local env: `.env.local` (never commit secrets).
- Convex env holds JWT keys; Vercel only needs `VITE_CONVEX_URL` + `VITE_CONVEX_SITE_URL`.
- OAuth: GitHub OAuth App credentials required for login.
## Convex Ops (Gotchas)
- New Convex functions must be pushed before `convex run`: use `bunx convex dev --once` (dev) or `bunx convex deploy` (prod).
- For non-interactive prod deploys, use `bunx convex deploy -y` to skip confirmation.
- If `bunx convex run --env-file .env.local ...` returns `401 MissingAccessToken` despite `bunx convex login`, workaround: omit `--env-file` and use `--deployment-name <name>` / `--prod`.
+187
View File
@@ -0,0 +1,187 @@
# Changelog
## Unreleased
### Added
### Changed
### Fixed
## 0.6.0 - 2026-02-10
### Added
- CLI/API: add `set-role` to change user roles (admin only).
- Security: quarantine skill publishes with VirusTotal scans + UI (thanks @aleph8, #130).
- Testing: add tests for badges, skillZip, uploadFiles expandDroppedItems, and ark schema error truncation.
- Moderation: add ban reasons to API/CLI and show in management UI.
### Changed
- Coverage: track `convex/lib/skillZip.ts` in coverage reports.
### Fixed
- Web: show pending-scan skills to owners without 404 (thanks @orlyjamie, #136).
- Users: backfill empty handles from name/email in ensure (thanks @adlai88, #158).
- Web: update footer branding to OpenClaw (thanks @jontsai, #122).
- Auth: restore soft-deleted users on reauth, block banned users (thanks @mkrokosz, #106).
## 0.5.0 - 2026-02-02
### Added
- Admin: ban users and delete owned skills from management console.
- Moderation: auto-hide skills after 4 unique reports; per-user report cap; moderators can ban users.
- Uploads: require GitHub accounts to be at least 7 days old for skill + soul publish/import.
- CLI: add `inspect` to fetch skill metadata/files without installing.
- CLI: add moderation commands for hide/unhide/delete and ban users.
- Management: add filters for reported skills and users.
### Changed
- Deps: update dependencies to latest available versions.
- Reporting: require reasons, show them in management console, warn about abuse bans.
### Fixed
- Bans: batch hard-delete cleanup to avoid Convex read limits on large skills.
## 0.4.0 - 2026-01-30
### Added
- Web: show published skills on user profiles (thanks @njoylab, #20).
- CLI: include ClawHub + Moltbot fallback skill roots for sync scans.
- CLI: support OpenClaw configuration files (`OPENCLAW_CONFIG_PATH` / `OPENCLAW_STATE_DIR`).
### Changed
- Brand: rebrand to ClawHub and publish CLI as `clawhub` (legacy `clawdhub` supported).
- Domain: default site/registry now `https://clawhub.ai`; `.well-known/clawhub.json` preferred.
- Theme: persist theme under `clawhub-theme` (legacy key still read).
### Fixed
- Registry: drop missing skills during search hydration (thanks @aaronn, #28).
- CLI: use path-based skill metadata lookup for updates (thanks @daveonkels, #22).
- Search: keep highlighted-only filtering and clamp vector candidates to Convex limits (thanks @aaronn, #30).
## 0.3.0 - 2026-01-19
### Added
- CLI: add `explore` command for latest updates, with limit clamping + tests/docs (thanks @jdrhyne, #14).
- CLI: `explore --json` output + new sorts (`installs`, `installsAllTime`, `trending`) and limit up to 200.
- API: `/api/v1/skills` supports installs + trending sorts (7-day installs).
- API: idempotent `POST/DELETE /api/v1/stars/{slug}` endpoints.
- Registry: trending leaderboard + daily stats backfill for installs-based sorts.
### Fixed
- Web: keep search mode navigation and state in sync (thanks @NACC96, #12).
## 0.2.0 - 2026-01-13
### Added
- Web: dynamic OG image cards for skills (name, description, version).
- CLI: auto-scan Clawdbot skill roots (per-agent workspaces, shared skills, extraDirs).
- Web: import skills from public GitHub URLs (auto-detect `SKILL.md`, smart file selection, provenance).
- Web/API: SoulHub (SOUL.md registry) with v1 endpoints and first-run auto-seed.
### Fixed
- Web: stabilize skill OG image generation on server runtimes.
- Web: prevent skill OG text overflow outside the card.
- Registry: make SoulHub auto-seed idempotent and non-user-owned.
- Registry: keep GitHub backup state + publish backups intact (thanks @joshp123, #1).
- CLI/Registry: restore fork lineage on sync + clamp bulk list queries (thanks @joshp123, #1).
- CLI: default workdir falls back to Clawdbot workspace (override with `--workdir` / `CLAWHUB_WORKDIR`).
## 0.0.6 - 2026-01-07
### Added
- API: v1 public REST endpoints with rate limits, raw file fetch, and OpenAPI spec.
- Docs: `docs/api.md` and `DEPRECATIONS.md` for the v1 cutover plan.
### Changed
- CLI: publish now uses single multipart `POST /api/v1/skills`.
- Registry: legacy `/api/*` + `/api/cli/*` marked for deprecation (kept for now).
## 0.0.5 - 2026-01-06
### Added
- Telemetry: track installs via `clawhub sync` (logged-in only), per root, with 120-day staleness.
- Skills: show current + all-time installs; sort by installs.
- Profile: private "Installed" tab with JSON export + delete telemetry controls.
- Docs: add `docs/telemetry.md` (what we track + how to opt out).
- Web: custom Open Graph image (`/og.png`) + richer OG/Twitter tags.
- Web: dashboard for managing your published skills (thanks @dbhurley!).
### Changed
- CLI: telemetry opt-out via `CLAWHUB_DISABLE_TELEMETRY=1`.
- Web: move theme picker into mobile menu.
### Fixed
- Web: handle shorthand hex colors in diff theme (thanks @dbhurley!).
## 0.0.5 - 2026-01-06
### Added
- Maintenance: admin backfill to re-parse `SKILL.md` and repair stored summaries/parsed metadata.
### Fixed
- CLI sync: ignore plural `skills.md` docs files when scanning for skills.
- Registry: parse YAML frontmatter (incl multiline `description`) and accept YAML `metadata` objects.
## 0.0.4 - 2026-01-05
### Added
- Web: `/skills` list view with sorting (newest/downloads/stars/name) + quick filter.
- Web: admin/moderator highlight toggle on skill detail.
- Web: canonical skill URLs as `/<owner>/<slug>` (legacy `/skills/<slug>` redirects).
- Web: upload auto-generates a changelog via OpenAI when left blank (marked as auto-generated).
### Fixed
- Web: skill detail shows a loading state instead of flashing "Skill not found".
- Web: user profile shows avatar + loading state (no "User not found" flash).
- Web: improved mobile responsiveness (nav menu, skill detail layout, install command overflow).
- Web: upload now unwraps folder picks so `SKILL.md` can be at the bundle root.
- Registry: cap embedding payload size to avoid model context errors.
- CLI: ignore legacy `auth.clawdhub.com` registry and prefer site discovery.
### Changed
- Web: homepage search now expands into full search mode with live results + highlighted toggle.
- CLI: sync no longer prompts for changelog; registry auto-generates when blank.
## 0.0.3 - 2026-01-04
### Added
- CLI sync: concurrency flag to limit registry checks.
- Home: install command switcher (npm/pnpm/bun).
### Changed
- CLI sync: default `--concurrency` is now 4 (was 8).
- CLI sync: replace boxed notes with plain output for long lists.
### Fixed
- CLI sync: wrap note output to avoid terminal overflow; cap list lengths.
- CLI sync: label fallback scans as fallback locations.
- CLI package: bundle schema internally (no external `clawhub-schema` publish).
- Repo: mark `clawhub-schema` as private to prevent publishing.
## 0.0.2 - 2026-01-04
### Added
- CLI: delete/undelete commands for soft-deleted skills (owner/admin).
### Fixed
- CLI sync: dedupe duplicate slugs across scan roots; skip duplicates to avoid double-publish errors.
- CLI sync: show parsing progress while hashing local skills.
- CLI sync: prompt only actionable skills; preselect all by default; list synced separately; condensed synced summary when nothing to sync.
- CLI sync: cap long status lists to avoid massive terminal boxes.
- CLI publish/sync: allow empty changelog on updates; registry accepts empty changelog for updates.
- CLI: use `--cli-version` to avoid conflict with skill `--version` flags.
- Registry: hide soft-deleted skills from search/skill/download unless restored.
- Tests: add delete/undelete coverage (unit + e2e).
## 0.0.1 - 2026-01-04
### Features
- CLI auth: login/logout/whoami; browser loopback auth; token storage; site/registry discovery; config overrides.
- CLI workflow: search, install, update (single/all), list, publish, sync (scan workdir + legacy roots), dry-run, version bumping, tags.
- Registry/API: skills + versions with semver; tags (latest + custom); changelog per version; SKILL.md frontmatter parsing; text-only validation; zip download; hash resolve; stats (downloads/stars/versions/comments).
- Web app: home (highlighted + latest), search, skill detail (README, versions, tags, stats, files), upload UI, user profiles, stars, settings (profile + API tokens + delete account).
- Social: stars + comments with moderation hooks; admin console for roles + highlighted curation.
- Search: semantic/vector search over skill content with limit/approved filters.
- Security: GitHub OAuth; role-based access (admin/moderator/user); audit logging for admin actions.
+7
View File
@@ -0,0 +1,7 @@
# Deprecations
## Legacy /api routes (pre-v1)
- Deprecated: 2026-01-07
- TODO: remove legacy `/api/*` and `/api/cli/*` routes after clients migrate to `/api/v1`.
- Legacy handlers live in `convex/http.ts` and `convex/httpApi.ts`.
+21
View File
@@ -0,0 +1,21 @@
MIT License
Copyright (c) 2026 Peter Steinberger
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
+151
View File
@@ -0,0 +1,151 @@
# ClawHub
<p align="center">
<a href="https://github.com/openclaw/clawhub/actions/workflows/ci.yml?branch=main"><img src="https://img.shields.io/github/actions/workflow/status/openclaw/clawhub/ci.yml?branch=main&style=for-the-badge" alt="CI status"></a>
<a href="https://discord.gg/clawd"><img src="https://img.shields.io/discord/1456350064065904867?label=Discord&logo=discord&logoColor=white&color=5865F2&style=for-the-badge" alt="Discord"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
</p>
ClawHub is the **public skill registry for Clawdbot**: publish, version, and search text-based agent skills (a `SKILL.md` plus supporting files).
Its designed for fast browsing + a CLI-friendly API, with moderation hooks and vector search.
onlycrabs.ai is the **SOUL.md registry**: publish and share system lore the same way you publish skills.
Live: `https://clawhub.ai`
onlycrabs.ai: `https://onlycrabs.ai`
## What you can do with it
- Browse skills + render their `SKILL.md`.
- Publish new skill versions with changelogs + tags (including `latest`).
- Browse souls + render their `SOUL.md`.
- Publish new soul versions with changelogs + tags.
- Search via embeddings (vector index) instead of brittle keywords.
- Star + comment; admins/mods can curate and approve skills.
## onlycrabs.ai (SOUL.md registry)
- Entry point is host-based: `onlycrabs.ai`.
- On the onlycrabs.ai host, the home page and nav default to souls.
- On ClawHub, souls live under `/souls`.
- Soul bundles only accept `SOUL.md` for now (no extra files).
## How it works (high level)
- Web app: TanStack Start (React, Vite/Nitro).
- Backend: Convex (DB + file storage + HTTP actions) + Convex Auth (GitHub OAuth).
- Search: OpenAI embeddings (`text-embedding-3-small`) + Convex vector search.
- API schema + routes: `packages/schema` (`clawhub-schema`).
## Telemetry
ClawHub tracks minimal **install telemetry** (to compute install counts) when you run `clawhub sync` while logged in.
Disable via:
```bash
export CLAWHUB_DISABLE_TELEMETRY=1
```
Details: `docs/telemetry.md`.
## Repo layout
- `src/` — TanStack Start app (routes, components, styles).
- `convex/` — schema + queries/mutations/actions + HTTP API routes.
- `packages/schema/` — shared API types/routes for the CLI and app.
- `docs/spec.md` — product + implementation spec (good first read).
## Local dev
Prereqs: Bun + Convex CLI.
```bash
bun install
cp .env.local.example .env.local
# terminal A: web app
bun run dev
# terminal B: Convex dev deployment
bunx convex dev
```
## Auth (GitHub OAuth) setup
Create a GitHub OAuth App, set `AUTH_GITHUB_ID` / `AUTH_GITHUB_SECRET`, then:
```bash
bunx auth --deployment-name <deployment> --web-server-url http://localhost:3000
```
This writes `JWT_PRIVATE_KEY` + `JWKS` to the deployment and prints values for your local `.env.local`.
## Environment
- `VITE_CONVEX_URL`: Convex deployment URL (`https://<deployment>.convex.cloud`).
- `VITE_CONVEX_SITE_URL`: Convex site URL (`https://<deployment>.convex.site`).
- `VITE_SOULHUB_SITE_URL`: onlycrabs.ai site URL (`https://onlycrabs.ai`).
- `VITE_SOULHUB_HOST`: onlycrabs.ai host match (`onlycrabs.ai`).
- `VITE_SITE_MODE`: Optional override (`skills` or `souls`) for SSR builds.
- `CONVEX_SITE_URL`: same as `VITE_CONVEX_SITE_URL` (auth + cookies).
- `SITE_URL`: App URL (local: `http://localhost:3000`).
- `AUTH_GITHUB_ID` / `AUTH_GITHUB_SECRET`: GitHub OAuth App.
- `JWT_PRIVATE_KEY` / `JWKS`: Convex Auth keys.
- `OPENAI_API_KEY`: embeddings for search + indexing.
## Nix plugins (nixmode skills)
ClawHub can store a nix-clawdbot plugin pointer in SKILL frontmatter so the registry knows which
Nix package bundle to install. A nix plugin is different from a regular skill pack: it bundles the
skill pack, the CLI binary, and its config flags/requirements together.
Add this to `SKILL.md`:
```yaml
---
name: peekaboo
description: Capture and automate macOS UI with the Peekaboo CLI.
metadata: {"clawdbot":{"nix":{"plugin":"github:clawdbot/nix-steipete-tools?dir=tools/peekaboo","systems":["aarch64-darwin"]}}}
---
```
Install via nix-clawdbot:
```nix
programs.clawdbot.plugins = [
{ source = "github:clawdbot/nix-steipete-tools?dir=tools/peekaboo"; }
];
```
You can also declare config requirements + an example snippet:
```yaml
---
name: padel
description: Check padel court availability and manage bookings via Playtomic.
metadata: {"clawdbot":{"config":{"requiredEnv":["PADEL_AUTH_FILE"],"stateDirs":[".config/padel"],"example":"config = { env = { PADEL_AUTH_FILE = \\\"/run/agenix/padel-auth\\\"; }; };"}}}
---
```
To show CLI help (recommended for nix plugins), include the `cli --help` output:
```yaml
---
name: padel
description: Check padel court availability and manage bookings via Playtomic.
metadata: {"clawdbot":{"cliHelp":"padel --help\\nUsage: padel [command]\\n"}}
---
```
`metadata.clawdbot` is preferred, but `metadata.clawdis` is accepted as an alias for compatibility.
## Scripts
```bash
bun run dev
bun run build
bun run test
bun run coverage
bun run lint
```
+41
View File
@@ -0,0 +1,41 @@
{
"$schema": "https://biomejs.dev/schemas/2.3.13/schema.json",
"files": {
"includes": [
"**",
"!**/.cta.json",
"!**/.vscode",
"!**/node_modules",
"!**/dist",
"!**/.output",
"!**/coverage",
"!**/convex/_generated",
"!**/test-results",
"!**/src/routeTree.gen.ts",
"!**/.tanstack",
"!**/public",
"!**/.devenv",
"!**/.devenv"
]
},
"assist": { "actions": { "source": { "organizeImports": "on" } } },
"formatter": {
"enabled": true,
"indentStyle": "space",
"indentWidth": 2,
"lineWidth": 100
},
"linter": {
"enabled": true,
"rules": {
"recommended": true
}
},
"javascript": {
"formatter": {
"quoteStyle": "single",
"semicolons": "asNeeded",
"trailingCommas": "all"
}
}
}
+1483
View File
File diff suppressed because it is too large Load Diff
Executable
+46
View File
@@ -0,0 +1,46 @@
#!/usr/bin/env bun
import { existsSync } from 'node:fs'
import { stat } from 'node:fs/promises'
import { fileURLToPath } from 'node:url'
const distCliUrl = new URL('./packages/clawdhub/dist/cli.js', import.meta.url)
const distCliPath = fileURLToPath(distCliUrl)
const srcRootPath = fileURLToPath(new URL('./packages/clawdhub/src/', import.meta.url))
const shouldBuild = await (async () => {
if (!existsSync(distCliPath)) return true
try {
const dist = await stat(distCliPath)
const latestSrcMtime = await getLatestMtime(srcRootPath)
return latestSrcMtime > dist.mtimeMs
} catch {
return true
}
})()
if (shouldBuild) {
const proc = Bun.spawn(['bunx', 'tsc', '-p', 'packages/clawdhub/tsconfig.json'], {
stdin: 'inherit',
stdout: 'inherit',
stderr: 'inherit',
})
const code = await proc.exited
if (code !== 0) process.exit(code)
}
await import(distCliUrl.href)
async function getLatestMtime(root: string) {
let latest = 0
const glob = new Bun.Glob('**/*.ts')
for await (const rel of glob.scan({ cwd: root, onlyFiles: true })) {
const path = `${root}${root.endsWith('/') ? '' : '/'}${rel}`
try {
const entry = await stat(path)
latest = Math.max(latest, entry.mtimeMs)
} catch {
// ignore
}
}
return latest
}
Executable
+46
View File
@@ -0,0 +1,46 @@
#!/usr/bin/env bun
import { existsSync } from 'node:fs'
import { stat } from 'node:fs/promises'
import { fileURLToPath } from 'node:url'
const distCliUrl = new URL('./packages/clawdhub/dist/cli.js', import.meta.url)
const distCliPath = fileURLToPath(distCliUrl)
const srcRootPath = fileURLToPath(new URL('./packages/clawdhub/src/', import.meta.url))
const shouldBuild = await (async () => {
if (!existsSync(distCliPath)) return true
try {
const dist = await stat(distCliPath)
const latestSrcMtime = await getLatestMtime(srcRootPath)
return latestSrcMtime > dist.mtimeMs
} catch {
return true
}
})()
if (shouldBuild) {
const proc = Bun.spawn(['bunx', 'tsc', '-p', 'packages/clawdhub/tsconfig.json'], {
stdin: 'inherit',
stdout: 'inherit',
stderr: 'inherit',
})
const code = await proc.exited
if (code !== 0) process.exit(code)
}
await import(distCliUrl.href)
async function getLatestMtime(root: string) {
let latest = 0
const glob = new Bun.Glob('**/*.ts')
for await (const rel of glob.scan({ cwd: root, onlyFiles: true })) {
const path = `${root}${root.endsWith('/') ? '' : '/'}${rel}`
try {
const entry = await stat(path)
latest = Math.max(latest, entry.mtimeMs)
} catch {
// ignore
}
}
return latest
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 832 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 67 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 112 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 214 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 835 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 116 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 210 KiB

@@ -1,23 +0,0 @@
# ClawHub UI Proof
Status: pass
Scenario: `/Users/patrickerichsen/.codex/worktrees/68a3/clawhub/.artifacts/proof-scenarios/sample-text-before-after.pw.ts`
Baseline: `origin/main`
Candidate: `worktree`
Provider: `hetzner`
## Artifacts
### baseline
- Output: `/Users/patrickerichsen/.codex/worktrees/68a3/clawhub/.artifacts/clawhub-ui-proof/2026-05-13T00-12-37-146Z/baseline`
- pass: baseline /skills - `baseline/screenshots/baseline-skills.png`
- pass: baseline /plugins - `baseline/screenshots/baseline-plugins.png`
- pass: baseline /souls - `baseline/screenshots/baseline-souls.png`
- Video: `baseline/full-run.mp4`
### candidate
- Output: `/Users/patrickerichsen/.codex/worktrees/68a3/clawhub/.artifacts/clawhub-ui-proof/2026-05-13T00-12-37-146Z/candidate`
- pass: candidate /skills - `candidate/screenshots/candidate-skills.png`
- pass: candidate /plugins - `candidate/screenshots/candidate-plugins.png`
- pass: candidate /souls - `candidate/screenshots/candidate-souls.png`
- Video: `candidate/full-run.mp4`
@@ -1,77 +0,0 @@
{
"baseline": "origin/main",
"candidate": "worktree",
"generatedAt": "2026-05-13T00:12:37.148Z",
"lanes": [
{
"localOutputDir": "/Users/patrickerichsen/.codex/worktrees/68a3/clawhub/.artifacts/clawhub-ui-proof/2026-05-13T00-12-37-146Z/baseline",
"name": "baseline",
"ref": "origin/main",
"remoteOutputDir": "/work/crabbox/cbx_2ac97d8c7cd2/clawhub/.artifacts/clawhub-ui-proof/remote-2026-05-13T00-12-37-146Z/baseline",
"status": "pass",
"steps": [
{
"lane": "baseline",
"name": "baseline /skills",
"screenshot": "screenshots/baseline-skills.png",
"slug": "baseline-skills",
"status": "pass"
},
{
"lane": "baseline",
"name": "baseline /plugins",
"screenshot": "screenshots/baseline-plugins.png",
"slug": "baseline-plugins",
"status": "pass"
},
{
"lane": "baseline",
"name": "baseline /souls",
"screenshot": "screenshots/baseline-souls.png",
"slug": "baseline-souls",
"status": "pass"
}
],
"videoPath": "/Users/patrickerichsen/.codex/worktrees/68a3/clawhub/.artifacts/clawhub-ui-proof/2026-05-13T00-12-37-146Z/baseline/full-run.mp4"
},
{
"localOutputDir": "/Users/patrickerichsen/.codex/worktrees/68a3/clawhub/.artifacts/clawhub-ui-proof/2026-05-13T00-12-37-146Z/candidate",
"name": "candidate",
"ref": "worktree",
"remoteOutputDir": "/work/crabbox/cbx_2ac97d8c7cd2/clawhub/.artifacts/clawhub-ui-proof/remote-2026-05-13T00-12-37-146Z/candidate",
"status": "pass",
"steps": [
{
"lane": "candidate",
"name": "candidate /skills",
"screenshot": "screenshots/candidate-skills.png",
"slug": "candidate-skills",
"status": "pass"
},
{
"lane": "candidate",
"name": "candidate /plugins",
"screenshot": "screenshots/candidate-plugins.png",
"slug": "candidate-plugins",
"status": "pass"
},
{
"lane": "candidate",
"name": "candidate /souls",
"screenshot": "screenshots/candidate-souls.png",
"slug": "candidate-souls",
"status": "pass"
}
],
"videoPath": "/Users/patrickerichsen/.codex/worktrees/68a3/clawhub/.artifacts/clawhub-ui-proof/2026-05-13T00-12-37-146Z/candidate/full-run.mp4"
}
],
"outputDir": "/Users/patrickerichsen/.codex/worktrees/68a3/clawhub/.artifacts/clawhub-ui-proof/2026-05-13T00-12-37-146Z",
"provider": "hetzner",
"scenario": "/Users/patrickerichsen/.codex/worktrees/68a3/clawhub/.artifacts/proof-scenarios/sample-text-before-after.pw.ts",
"status": "pass",
"crabbox": {
"createdLease": true,
"leaseId": "cbx_2ac97d8c7cd2"
}
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 29 KiB

@@ -1,11 +0,0 @@
# ClawHub UI Proof
Status: pass
Mode: `feature`
Scenario: `e2e/local-auth/security-scan-management-proof.pw.test.ts`
Provider: `local-auth`
## Artifacts
- pass: Desktop management security scans - `candidate/screenshots/desktop-security-scans.png`
- pass: Mobile management security scans - `candidate/screenshots/mobile-security-scans.png`
@@ -1,34 +0,0 @@
{
"baseline": "not run",
"candidate": "pe/security-scan-admin-tooling",
"generatedAt": "2026-05-18T21:32:12.809Z",
"lanes": [
{
"localOutputDir": "/Users/patrickerichsen/Git/openclaw/clawhub/.artifacts/clawhub-ui-proof/2026-05-18T21-29-29Z-security-scans/candidate",
"name": "candidate",
"ref": "pe/security-scan-admin-tooling",
"status": "pass",
"steps": [
{
"lane": "candidate",
"name": "Desktop management security scans",
"screenshot": "screenshots/desktop-security-scans.png",
"slug": "desktop-security-scans",
"status": "pass"
},
{
"lane": "candidate",
"name": "Mobile management security scans",
"screenshot": "screenshots/mobile-security-scans.png",
"slug": "mobile-security-scans",
"status": "pass"
}
]
}
],
"mode": "feature",
"outputDir": "/Users/patrickerichsen/Git/openclaw/clawhub/.artifacts/clawhub-ui-proof/2026-05-18T21-29-29Z-security-scans",
"provider": "local-auth",
"scenario": "e2e/local-auth/security-scan-management-proof.pw.test.ts",
"status": "pass"
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 100 KiB

@@ -1,5 +0,0 @@
# Owner-Scoped Skill Slugs UI Proof
- Scenario: owner-scoped skill slug UI surfaces.
- Skill detail page proof: owner-qualified route and install command render as `@local/padel`.
- Install command proof: copyable command uses `openclaw skills install @local/padel`.
@@ -1,26 +0,0 @@
{
"status": "passed",
"mode": "feature",
"scenario": "owner-scoped skill slug UI surfaces",
"provider": "Codex local browser proof",
"candidate": "pe/owner-scoped-skill-slugs",
"lanes": [
{
"name": "owner-scoped-skill-slugs",
"steps": [
{
"name": "Skill detail page shows owner-qualified route and install ref",
"slug": "skill-page-owner-ref",
"status": "passed",
"screenshot": "skill-page-owner-ref.png"
},
{
"name": "Install command uses @owner/slug",
"slug": "install-command-owner-ref",
"status": "passed",
"screenshot": "install-command-owner-ref.png"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 593 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 611 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 512 KiB

@@ -1,7 +0,0 @@
# Management Security Scan Overview
Feature proof for PR #2403.
- Desktop overview shows ClawScan-first current verdict totals, pipeline status, recent scan window, category rollups, and failed scan samples.
- Desktop drilldown shows a selected artifact with ClawScan verdict/category/summary first, followed by pipeline status and supporting scanner evidence.
- Mobile view keeps the management security overview usable at narrow width without overlapping controls.
@@ -1,32 +0,0 @@
{
"status": "passed",
"mode": "feature",
"scenario": "management-security-scan-overview",
"provider": "local-playwright",
"candidate": "pe/clawscan-visibility",
"lanes": [
{
"name": "candidate",
"steps": [
{
"name": "Management security overview",
"slug": "management-security-overview-desktop",
"status": "passed",
"screenshot": "management-security-overview-desktop.png"
},
{
"name": "Artifact drilldown",
"slug": "management-security-drilldown-desktop",
"status": "passed",
"screenshot": "management-security-drilldown-desktop.png"
},
{
"name": "Mobile management security overview",
"slug": "management-security-mobile",
"status": "passed",
"screenshot": "management-security-mobile.png"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 162 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 59 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 161 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 61 KiB

@@ -1,12 +0,0 @@
# ClawHub UI Proof
Status: pass
Scenario: Skill grid card metadata layout with nearby skills
Screenshots:
- baseline desktop: baseline/screenshots/desktop-grid-context.png
- candidate desktop: candidate/screenshots/desktop-grid-context.png
- baseline mobile: baseline/screenshots/mobile-grid-context.png
- candidate mobile: candidate/screenshots/mobile-grid-context.png
Observed target card: Self-Improving + Proactive Agent.
@@ -1,156 +0,0 @@
{
"baseline": "origin/main",
"candidate": "jesse/fix-skill-card-date-overlap",
"generatedAt": "2026-06-01T16:29:49.092Z",
"lanes": [
{
"name": "baseline",
"lane": "baseline",
"ref": "origin/main",
"baseURL": "http://127.0.0.1:3038",
"localOutputDir": "/Users/jmerhi/repos/claw-working-space/clawhub-fix-skill-card-date-overlap/.artifacts/clawhub-ui-proof/skill-card-grid-context-1780331337362/baseline",
"status": "pass",
"steps": [
{
"name": "Desktop skills grid context",
"slug": "desktop-grid-context",
"screenshot": "screenshots/desktop-grid-context.png",
"status": "pass"
},
{
"name": "Mobile skills grid context",
"slug": "mobile-grid-context",
"screenshot": "screenshots/mobile-grid-context.png",
"status": "pass"
}
],
"metrics": [
{
"step": "desktop grid context",
"viewport": "desktop",
"children": [
{
"className": "skill-card-tags",
"text": "LinuxmacOSWindows"
},
{
"className": "skill-card-header",
"text": "Self-Improving + Proactive Agent"
},
{
"className": "skill-card-summary",
"text": "Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when..."
},
{
"className": "skill-card-footer",
"text": "by@ivangdavilaUpdated 3w ago1.2k·195k"
}
],
"tagsBelowSummary": false,
"authorToUpdatedGap": 14
},
{
"step": "mobile grid context",
"viewport": "mobile",
"children": [
{
"className": "skill-card-tags",
"text": "LinuxmacOSWindows"
},
{
"className": "skill-card-header",
"text": "Self-Improving + Proactive Agent"
},
{
"className": "skill-card-summary",
"text": "Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when..."
},
{
"className": "skill-card-footer",
"text": "by@ivangdavilaUpdated 3w ago1.2k·195k"
}
],
"tagsBelowSummary": false,
"authorToUpdatedGap": 14
}
]
},
{
"name": "candidate",
"lane": "candidate",
"ref": "jesse/fix-skill-card-date-overlap",
"baseURL": "http://127.0.0.1:3037",
"localOutputDir": "/Users/jmerhi/repos/claw-working-space/clawhub-fix-skill-card-date-overlap/.artifacts/clawhub-ui-proof/skill-card-grid-context-1780331337362/candidate",
"status": "pass",
"steps": [
{
"name": "Desktop skills grid context",
"slug": "desktop-grid-context",
"screenshot": "screenshots/desktop-grid-context.png",
"status": "pass"
},
{
"name": "Mobile skills grid context",
"slug": "mobile-grid-context",
"screenshot": "screenshots/mobile-grid-context.png",
"status": "pass"
}
],
"metrics": [
{
"step": "desktop grid context",
"viewport": "desktop",
"children": [
{
"className": "skill-card-header",
"text": "Self-Improving + Proactive Agent"
},
{
"className": "skill-card-summary",
"text": "Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when..."
},
{
"className": "skill-card-tags",
"text": "LinuxmacOSWindows"
},
{
"className": "skill-card-footer",
"text": "by@ivangdavilaUpdated 3w ago1.2k·195k"
}
],
"tagsBelowSummary": true,
"authorToUpdatedGap": 8
},
{
"step": "mobile grid context",
"viewport": "mobile",
"children": [
{
"className": "skill-card-header",
"text": "Self-Improving + Proactive Agent"
},
{
"className": "skill-card-summary",
"text": "Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when..."
},
{
"className": "skill-card-tags",
"text": "LinuxmacOSWindows"
},
{
"className": "skill-card-footer",
"text": "by@ivangdavilaUpdated 3w ago1.2k·195k"
}
],
"tagsBelowSummary": true,
"authorToUpdatedGap": 8
}
]
}
],
"mode": "before-after",
"outputDir": "/Users/jmerhi/repos/claw-working-space/clawhub-fix-skill-card-date-overlap/.artifacts/clawhub-ui-proof/skill-card-grid-context-1780331337362",
"provider": "local",
"scenario": "Skill grid card metadata layout with nearby skills",
"status": "pass"
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 19 KiB

@@ -1,6 +0,0 @@
# ClawHub UI Proof
Status: pass
Mode: before-after
Scenario: Skill grid card metadata layout
@@ -1,55 +0,0 @@
{
"baseline": "origin/main",
"candidate": "jesse/fix-skill-card-date-overlap",
"lanes": [
{
"baseURL": "http://127.0.0.1:3038",
"lane": "baseline",
"name": "baseline",
"localOutputDir": "/Users/jmerhi/repos/claw-working-space/clawhub-fix-skill-card-date-overlap/.artifacts/clawhub-ui-proof/skill-card-metadata-1780328491887/baseline",
"ref": "origin/main",
"status": "pass",
"steps": [
{
"name": "Desktop skill card",
"slug": "desktop-skill-card",
"screenshot": "screenshots/desktop-skill-card.png",
"status": "pass"
},
{
"name": "Mobile skill card",
"slug": "mobile-skill-card",
"screenshot": "screenshots/mobile-skill-card.png",
"status": "pass"
}
]
},
{
"baseURL": "http://127.0.0.1:3037",
"lane": "candidate",
"name": "candidate",
"localOutputDir": "/Users/jmerhi/repos/claw-working-space/clawhub-fix-skill-card-date-overlap/.artifacts/clawhub-ui-proof/skill-card-metadata-1780328491887/candidate",
"ref": "jesse/fix-skill-card-date-overlap",
"status": "pass",
"steps": [
{
"name": "Desktop skill card",
"slug": "desktop-skill-card",
"screenshot": "screenshots/desktop-skill-card.png",
"status": "pass"
},
{
"name": "Mobile skill card",
"slug": "mobile-skill-card",
"screenshot": "screenshots/mobile-skill-card.png",
"status": "pass"
}
]
}
],
"mode": "before-after",
"outputDir": "/Users/jmerhi/repos/claw-working-space/clawhub-fix-skill-card-date-overlap/.artifacts/clawhub-ui-proof/skill-card-metadata-1780328491887",
"provider": "local",
"scenario": "Skill grid card metadata layout",
"status": "pass"
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 74 KiB

@@ -1,14 +0,0 @@
# ClawHub UI Proof
Status: `passed`
Mode: `feature`
Scenario: `manual-plugin-download-counts`
Provider: `local-playwright`
## Candidate
- `http://127.0.0.1:3001/plugins/clawbits-openclaw-plugin`
- Confirms plugin detail pages render `Downloads` as the first sidebar stat, above repository and owner metadata.
@@ -1,21 +0,0 @@
{
"status": "passed",
"mode": "feature",
"scenario": "manual-plugin-download-counts",
"provider": "local-playwright",
"baseline": "not-run",
"candidate": "pe/plugin-download-counts",
"lanes": [
{
"name": "candidate",
"steps": [
{
"name": "Plugin detail downloads top stat",
"slug": "plugin-downloads-top",
"status": "passed",
"screenshot": "plugin-downloads-top.png"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 52 KiB

@@ -1,6 +0,0 @@
# ClawHub UI Proof
- Status: passed
- Mode: feature
- Scenario: plugin-list-downloads-sort
- Proof: plugin list shows the Most downloaded sort option selected and download counts in list rows.
@@ -1,20 +0,0 @@
{
"status": "passed",
"mode": "feature",
"scenario": "plugin-list-downloads-sort",
"provider": "codex-in-app-browser",
"candidate": "pe/plugin-download-counts",
"lanes": [
{
"name": "candidate",
"steps": [
{
"name": "Plugin list downloads and sort",
"slug": "plugin-list-downloads-sort",
"status": "passed",
"screenshot": "plugin-list-downloads-sort.png"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 30 KiB

@@ -1,6 +0,0 @@
# ClawHub UI Proof
- Status: passed
- Mode: feature
- Scenario: plugin-list-no-family-badges
- Proof: plugin list still shows download counts while Code Plugin and Bundle Plugin family badges are absent.
@@ -1,20 +0,0 @@
{
"status": "passed",
"mode": "feature",
"scenario": "plugin-list-no-family-badges",
"provider": "codex-in-app-browser",
"candidate": "pe/plugin-download-counts",
"lanes": [
{
"name": "candidate",
"steps": [
{
"name": "Plugin list without family badges",
"slug": "plugin-list-no-family-badges",
"status": "passed",
"screenshot": "plugin-list-no-family-badges.png"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 124 KiB

@@ -1,6 +0,0 @@
# PR #2520 proof
Status: pass
- Rendered the account-ban and artifact-level scanner rejection emails from the real email builders; the account-ban email no longer includes scan-results appeal guidance, while the artifact-level email still includes local scan guidance.
- Captured the dedicated banned-account appeal page from a running local ClawHub preview after `/dashboard?error_description=Account%20banned` redirected to `/account-banned`.
@@ -1,32 +0,0 @@
{
"generatedAt": "2026-06-05T23:54:26.000Z",
"mode": "feature",
"status": "pass",
"provider": "rendered email builder plus live in-app browser preview",
"scenario": "account-ban email without scan-results block plus dedicated banned-account route",
"candidate": "worktree 3b4cc2d9",
"outputDir": ".artifacts/pr-2520-proof",
"lanes": [
{
"name": "candidate",
"ref": "worktree 3b4cc2d9",
"status": "pass",
"steps": [
{
"lane": "candidate",
"name": "Rendered moderation emails",
"slug": "rendered-emails",
"status": "pass",
"screenshot": "screenshots/rendered-emails.png"
},
{
"lane": "candidate",
"name": "Dedicated banned-account appeal page",
"slug": "banned-sign-in",
"status": "pass",
"screenshot": "screenshots/banned-sign-in.png"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 119 KiB

@@ -1,6 +0,0 @@
# PR #2520 proof
Status: pass
- Rendered the account-ban and artifact-level scanner rejection emails from the real email builders.
- Captured the banned-account sign-in copy from a full-stack local ClawHub preview with local Convex on `/dashboard?error_description=Account%20banned`.
@@ -1,32 +0,0 @@
{
"generatedAt": "2026-06-05T23:09:45.000Z",
"mode": "feature",
"status": "pass",
"provider": "rendered email builder plus full-stack local-auth Playwright",
"scenario": "email builder rendering plus live ClawHub dashboard auth-error route",
"candidate": "worktree 03bc802e",
"outputDir": ".artifacts/pr-2520-proof",
"lanes": [
{
"name": "candidate",
"ref": "worktree 03bc802e",
"status": "pass",
"steps": [
{
"lane": "candidate",
"name": "Rendered moderation emails",
"slug": "rendered-emails",
"status": "pass",
"screenshot": "screenshots/rendered-emails.png"
},
{
"lane": "candidate",
"name": "Live banned-account dashboard sign-in copy",
"slug": "banned-sign-in",
"status": "pass",
"screenshot": "screenshots/banned-sign-in.png"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 119 KiB

@@ -1,6 +0,0 @@
# PR #2520 proof
Status: pass
- Rendered the account-ban and artifact-level scanner rejection emails from the real email builders.
- Captured the banned-account sign-in copy from a full-stack local ClawHub preview with local Convex on `/dashboard?error_description=Account%20banned`.
@@ -1,32 +0,0 @@
{
"generatedAt": "2026-06-05T23:09:45.000Z",
"mode": "feature",
"status": "pass",
"provider": "rendered email builder plus full-stack local-auth Playwright",
"scenario": "email builder rendering plus live ClawHub dashboard auth-error route",
"candidate": "worktree 03bc802e",
"outputDir": ".artifacts/pr-2520-proof",
"lanes": [
{
"name": "candidate",
"ref": "worktree 03bc802e",
"status": "pass",
"steps": [
{
"lane": "candidate",
"name": "Rendered moderation emails",
"slug": "rendered-emails",
"status": "pass",
"screenshot": "screenshots/rendered-emails.png"
},
{
"lane": "candidate",
"name": "Live banned-account dashboard sign-in copy",
"slug": "banned-sign-in",
"status": "pass",
"screenshot": "screenshots/banned-sign-in.png"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 63 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 350 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 332 KiB

@@ -1,13 +0,0 @@
# PR 2520 live local proof
Status: pass
Captured from a live local ClawHub dev server started with `bun run dev` at `http://localhost:3000`.
Screenshots cover:
- dedicated account-banned page at desktop and mobile widths
- moderation email output generated from `convex/lib/emails.ts` and served through the same local ClawHub dev server
- account-ban email appeal-only copy
- skill rejection email with `clawhub scan download demo-skill --version 1.2.3`
- plugin rejection email with `clawhub scan download @scope/demo --version 2.0.0 --kind plugin`
@@ -1,46 +0,0 @@
{
"status": "pass",
"mode": "feature",
"provider": "local ClawHub dev server",
"localServer": "bun run dev -> http://localhost:3000",
"commit": "03bcca63",
"generatedAt": "2026-06-06T00:39:17.133Z",
"screenshots": [
{
"slug": "account-banned-desktop",
"url": "http://localhost:3000/account-banned",
"viewport": {
"width": 1440,
"height": 980
},
"screenshot": "candidate/screenshots/account-banned-desktop.png"
},
{
"slug": "account-banned-mobile",
"url": "http://localhost:3000/account-banned",
"viewport": {
"width": 390,
"height": 844
},
"screenshot": "candidate/screenshots/account-banned-mobile.png"
},
{
"slug": "moderation-emails-desktop",
"url": "http://localhost:3000/__pr-2520-email-proof.html",
"viewport": {
"width": 1440,
"height": 1200
},
"screenshot": "candidate/screenshots/moderation-emails-desktop.png"
},
{
"slug": "moderation-emails-mobile",
"url": "http://localhost:3000/__pr-2520-email-proof.html",
"viewport": {
"width": 390,
"height": 1200
},
"screenshot": "candidate/screenshots/moderation-emails-mobile.png"
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 30 KiB

@@ -1,6 +0,0 @@
# ClawHub UI Proof
- Status: passed
- Mode: feature
- Scenario: plugin-list-no-family-badges
- Proof: plugin list still shows download counts while Code Plugin and Bundle Plugin family badges are absent.
@@ -1,20 +0,0 @@
{
"status": "passed",
"mode": "feature",
"scenario": "plugin-list-no-family-badges",
"provider": "codex-in-app-browser",
"candidate": "pe/plugin-download-counts",
"lanes": [
{
"name": "candidate",
"steps": [
{
"name": "Plugin list without family badges",
"slug": "plugin-list-no-family-badges",
"status": "passed",
"screenshot": "plugin-list-no-family-badges.png"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 98 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 44 KiB

@@ -1,6 +0,0 @@
# ClawHub UI Proof
Status: pass
- Account deletion confirmation renders one row per affected skill/plugin, with icon, name, publisher handle, and type badge.
- Post-cleanup navigation to the deleted plugin shows `Plugin not found`, confirming the resource was removed by the account deletion flow.
@@ -1,32 +0,0 @@
{
"status": "pass",
"mode": "feature",
"scenario": "e2e/local-auth/delete-account-resources.pw.test.ts",
"provider": "local-auth Playwright",
"baseline": null,
"candidate": "pe/account-deletion-hard-delete",
"generatedAt": "2026-06-06T00:37:39.268Z",
"lanes": [
{
"name": "candidate",
"ref": "pe/account-deletion-hard-delete",
"status": "pass",
"steps": [
{
"lane": "candidate",
"name": "Account deletion confirmation lists each resource row",
"screenshot": "screenshots/account-deletion-confirmation.png",
"slug": "account-deletion-confirmation",
"status": "pass"
},
{
"lane": "candidate",
"name": "Deleted plugin route shows resource removed",
"screenshot": "screenshots/account-deletion-post-cleanup.png",
"slug": "account-deletion-post-cleanup",
"status": "pass"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 99 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 156 KiB

@@ -1,10 +0,0 @@
# Skill Settings Delete Action
Real-browser feature proof for the skill settings delete action.
- Route: local-auth seeded skill settings page
- Browser: Playwright chromium
- Candidate: pe/skill-settings-delete-action
- Screenshots:
- `local/delete-action.png`
- `local/delete-dialog.png`
@@ -1,26 +0,0 @@
{
"status": "passed",
"mode": "feature",
"scenario": "skill-settings-delete-action",
"provider": "local-auth Playwright chromium",
"candidate": "pe/skill-settings-delete-action",
"lanes": [
{
"name": "local",
"steps": [
{
"name": "Skill settings delete action",
"slug": "delete-action",
"status": "passed",
"screenshot": "delete-action.png"
},
{
"name": "Skill settings delete confirmation dialog",
"slug": "delete-dialog",
"status": "passed",
"screenshot": "delete-dialog.png"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 505 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 439 KiB

@@ -1,11 +0,0 @@
# PR 2581 prod-backed UI proof
Status: passed
Mode: feature
Backend: production Convex read data (`wry-manatee-359`).
Pages captured:
- `/skills?sort=installs&dir=desc` showing prod skill rows and install sort.
- `/search?q=swarm` showing prod search results.
- `/chair4ce/swarm` showing a prod-backed skill detail page.
Note: default `/plugins` was not used because this PR head can request `sort=recommended`, which requires matching backend code that is not deployed to prod yet.
@@ -1,32 +0,0 @@
{
"status": "passed",
"mode": "feature",
"scenario": "manual prod-backed PR proof: skills browse, search, and detail",
"provider": "local Playwright against http://127.0.0.1:3007 with prod Convex",
"candidate": "PR #2581 rebased head f43b8ed3",
"lanes": [
{
"name": "candidate",
"steps": [
{
"name": "Skills browse sorted by installs",
"slug": "skills-installs",
"status": "passed",
"screenshot": "skills-installs.png"
},
{
"name": "Search results for swarm",
"slug": "search-swarm",
"status": "passed",
"screenshot": "search-swarm.png"
},
{
"name": "Skill detail for chair4ce/swarm",
"slug": "skill-detail-swarm",
"status": "passed",
"screenshot": "skill-detail-swarm.png"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 691 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 62 KiB

@@ -1,5 +0,0 @@
# CLAW-283 Email Template Proof
- Rendered updated ClawHub transactional email templates with realistic sample data.
- Rendered generic admin one-off email with sample title/body/action content.
- Confirmed Plugin Inspector findings email renders without the removed ClawHub CTA button.
@@ -1,32 +0,0 @@
{
"status": "passed",
"mode": "feature",
"scenario": "CLAW-283 email template render proof",
"provider": "local ClawHub email preview render",
"candidate": "pe/claw-283-email-templates",
"lanes": [
{
"name": "candidate",
"steps": [
{
"name": "Rendered email template proof",
"slug": "email-template-render-proof",
"status": "passed",
"screenshot": "email-template-render-proof.png"
},
{
"name": "Generic one-off email proof",
"slug": "admin-one-off-email",
"status": "passed",
"screenshot": "admin-one-off-email.png"
},
{
"name": "Plugin Inspector findings proof",
"slug": "plugin-inspector-findings",
"status": "passed",
"screenshot": "plugin-inspector-findings.png"
}
]
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 98 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 96 KiB

Some files were not shown because too many files have changed in this diff Show More