Skip to content

Add Promptty extension - #29869

Merged
raycastbot merged 5 commits into
raycast:mainfrom
michalkos:ext/promptty
Aug 17, 2026
Merged

Add Promptty extension#29869
raycastbot merged 5 commits into
raycast:mainfrom
michalkos:ext/promptty

Conversation

@michalkos

@michalkos michalkos commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Description

Adds a Raycast extension for searching prompts saved in Promptty for Mac.

The Search Promptty command lets users:

  • search prompt titles, content, and categories;
  • preview the full prompt and its metadata;
  • paste a selected prompt into the previously active app;
  • copy a prompt to the clipboard;
  • rank favorites first using Raycast-local frecency.

The extension reads Promptty's versioned, read-only local JSON snapshot. It does not access SwiftData, SQLite, CloudKit, or the Promptty web API, and it makes no network requests. A bounded last-known-good cache keeps prompts available if the latest snapshot is temporarily unavailable or malformed.

Requires Promptty for Mac 1.4.0 or later. Missing, incompatible, stale, malformed, and permission-related snapshot states include guidance or recovery actions.

Screencast

screnrecord.mov

Checklist

- Consolidate Promptty Raycast extension
- Merge branch \'contributions/merge-1785437642996\'
- Pull contributions
- Refactor snapshot loading logic to handle cache errors more gracefully and improve validation of cached snapshots. Update tests to reflect changes in cache behavior and ensure correct handling of source paths.
- Update .gitignore to exclude AGENTS.md
- Exclude screenshot source assets
- Merge branch \'contributions/merge-1785435958282\'
- Pull contributions
- Fix Promptty metadata screenshot alignment
- Address Raycast review feedback
- Initial Promptty Raycast extension
@raycastbot raycastbot added the new extension Label for PRs with new extensions label Jul 30, 2026
@raycastbot

Copy link
Copy Markdown
Collaborator

Congratulations on your new Raycast extension! 🚀

We're currently experiencing a high volume of incoming requests. As a result, the initial review may take up to 15 business days.

Once the PR is approved and merged, the extension will be available on our Store.

@michalkos michalkos changed the title Add promptty extension Add Promptty extension Jul 30, 2026
Comment thread extensions/promptty/src/lib/search.ts Outdated
Comment thread extensions/promptty/src/lib/snapshot.ts
@greptile-apps

greptile-apps Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Adds a new Promptty extension for browsing and searching a local prompt snapshot.

  • Provides prompt previews, paste/copy actions, favorites-first frecency ordering, compatibility checks, and user-facing recovery states.
  • Adds source-aware, size-bounded last-known-good caching for unavailable or malformed snapshots.
  • Includes extension metadata, documentation, fixtures, and tests for snapshot loading, path resolution, search normalization, and cache behavior.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
extensions/promptty/src/lib/search.ts Implements locale-independent search normalization and relevance ordering; the previously reported locale-dependent matching issue is fixed.
extensions/promptty/src/lib/snapshot.ts Parses and validates snapshots and maintains a source-bound fallback cache; both previously reported oversized-cache behaviors are fixed.
extensions/promptty/src/lib/cache.ts Provides the Raycast cache adapter used by the source-aware snapshot fallback.
extensions/promptty/src/lib/compatibility.ts Validates and compares Promptty versions using a linear-time version-format expression.
extensions/promptty/src/search-promptty.tsx Implements the main search command, loading states, recovery actions, prompt rendering, and frecency integration.
extensions/promptty/tests/search.test.ts Covers case, diacritic, Turkish dotted-I, token, and ordering behavior.
extensions/promptty/tests/snapshot.test.ts Covers validation, fallback caching, source isolation, oversized exports, legacy cache cleanup, and malformed snapshots.

Reviews (5): Last reviewed commit: "Update CHANGELOG.md and optimise images" | Re-trigger Greptile

…malizeSearchText` to use `toLowerCase` for consistent case folding, and added a test for Turkish characters. Modified `loadSnapshotWithCache` to remove the last-known-good cache when a newer export exceeds the cache budget, with corresponding tests for this behavior.
Comment thread extensions/promptty/src/lib/snapshot.ts
…troduced `isCachedSourceId` function to validate cached entries and added a test to ensure that a newer export exceeding the cache budget does not affect another source\'s last-known-good cache.
@michalkos
michalkos marked this pull request as ready for review July 30, 2026 20:53
@0xdhrv 0xdhrv self-assigned this Aug 17, 2026
- Add Open Promptty, update, preferences, and reload actions
- Use Raycast promise loading with explicit error handling
- Improve empty-state messaging and exhaustive error handling
- Add extension and command keywords for prompt discovery
- Update documentation, changelog, ignore rules, and formatting

@0xdhrv 0xdhrv left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me, approved ✅

@raycastbot
raycastbot merged commit 4f05221 into raycast:main Aug 17, 2026
2 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

Published to the Raycast Store:
https://raycast.com/michalkos/promptty

@raycastbot

Copy link
Copy Markdown
Collaborator

🎉 🎉 🎉

Such a great contribution deserves a reward, but unfortunately we couldn't find your Raycast account based on your GitHub username (@michalkos).

Please link your GitHub account to your Raycast account to receive your credits and soon be able to exchange them for some swag.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new extension Label for PRs with new extensions platform: macOS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants