Skip to content

Conversation

@jsoyer
Copy link

@jsoyer jsoyer commented Feb 12, 2026

Description

Screencast

Checklist

@raycastbot raycastbot added the new extension Label for PRs with new extensions label Feb 12, 2026
@raycastbot
Copy link
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 10-15 business days.

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

@jsoyer jsoyer marked this pull request as ready for review February 12, 2026 17:49
@greptile-apps
Copy link
Contributor

greptile-apps bot commented Feb 12, 2026

Greptile Overview

Greptile Summary

This PR adds a new Kitty terminal extension that provides remote control capabilities via Kitty's Unix socket protocol. The extension includes commands to create windows/tabs, search tabs, manage launch configurations, and open Finder folders in Kitty.

Key changes:

  • Added 5 commands: new window, new tab, search tabs, launch configurations, and open with Kitty
  • Implemented comprehensive remote control wrapper using kitten @ protocol
  • YAML-based launch configuration system for multi-tab/split layouts
  • Auto-detection of Kitty socket with fallback to manual configuration
  • Setup guide for users who haven't enabled remote control

Issues found:

  • Missing required metadata/ folder with screenshots for view commands
  • CHANGELOG date should use {PR_MERGE_DATE} placeholder instead of hardcoded date

The code quality is high with proper error handling, TypeScript types, and user-friendly setup instructions. The extension follows Raycast conventions and includes appropriate fallbacks for various error states.

Confidence Score: 3/5

  • Cannot be merged until metadata folder with screenshots is added
  • The code implementation is solid with good error handling and follows Raycast conventions. However, the extension has view-type commands and is missing the required metadata folder with screenshots, which is a blocking requirement per the extension guidelines. Additionally, the CHANGELOG needs a minor date format fix.
  • extensions/kitty/package.json (missing metadata folder), extensions/kitty/CHANGELOG.md (date format)

Important Files Changed

Filename Overview
extensions/kitty/CHANGELOG.md Date needs placeholder format, otherwise well-structured
extensions/kitty/package.json Missing required metadata folder with screenshots for view commands
extensions/kitty/src/utils/kitty-remote.ts Solid remote control implementation with good error handling
extensions/kitty/src/search-kitty-tabs.tsx Well-implemented tab search with proper error handling and setup guide
extensions/kitty/src/open-kitty-launch-config.tsx Clean YAML-based launch configuration manager with validation

Copy link
Contributor

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

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

17 files reviewed, 2 comments

Edit Code Review Agent Settings | Greptile

@@ -0,0 +1,9 @@
# Kitty Raycast Extension Changelog

## [Initial Version] - 2026-02-12
Copy link
Contributor

Choose a reason for hiding this comment

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

Date should use {PR_MERGE_DATE} placeholder for initial version

Suggested change
## [Initial Version] - 2026-02-12
## [Initial Version] - {PR_MERGE_DATE}

Context Used: Rule from dashboard - What: Changelog entries must use {PR_MERGE_DATE} placeholder in titles, be placed at the top of th... (source)

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Comment on lines +1 to +78
{
"$schema": "https://www.raycast.com/schemas/extension.json",
"name": "kitty",
"title": "Kitty",
"description": "Control Kitty terminal via its remote control protocol",
"icon": "extension-icon.png",
"author": "jerome_soyer",
"categories": ["Applications", "Developer Tools"],
"license": "MIT",
"preferences": [
{
"name": "socketPath",
"title": "Socket Path",
"description": "Path to the Kitty remote control socket. Leave empty to auto-detect /tmp/kitty-socket-{pid}",
"type": "textfield",
"required": false,
"default": ""
}
],
"commands": [
{
"name": "new-kitty-window",
"title": "New Kitty Window",
"subtitle": "Kitty",
"description": "Open a new Kitty OS window",
"mode": "no-view"
},
{
"name": "new-kitty-tab",
"title": "New Kitty Tab",
"subtitle": "Kitty",
"description": "Open a new tab in the active Kitty window",
"mode": "no-view"
},
{
"name": "search-kitty-tabs",
"title": "Search Kitty Tabs",
"subtitle": "Kitty",
"description": "Search and focus Kitty tabs across all windows",
"mode": "view"
},
{
"name": "open-kitty-launch-config",
"title": "Open Kitty Launch Configuration",
"subtitle": "Kitty",
"description": "Manage and launch multi-tab/split configurations",
"mode": "view"
},
{
"name": "open-with-kitty",
"title": "Open with Kitty",
"subtitle": "Kitty",
"description": "Open the selected Finder folder in Kitty",
"mode": "no-view"
}
],
"dependencies": {
"@raycast/api": "^1.89.0",
"@raycast/utils": "^1.17.0",
"yaml": "^2.7.0"
},
"devDependencies": {
"@raycast/eslint-config": "^1.0.11",
"@types/node": "22.13.4",
"@types/react": "19.0.8",
"eslint": "^8.57.0",
"prettier": "^3.4.2",
"typescript": "^5.7.3"
},
"scripts": {
"build": "ray build",
"dev": "ray develop",
"fix-lint": "ray lint --fix",
"lint": "ray lint",
"prepublishOnly": "echo \"Error: no publish\" && exit 1",
"publish": "npx @raycast/api@latest publish"
}
}
Copy link
Contributor

Choose a reason for hiding this comment

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

Missing metadata/ folder with screenshots - this extension has view-type commands (search-kitty-tabs and open-kitty-launch-config) and requires Raycast-styled screenshots in a metadata folder per the extension guidelines.

Context Used: Rule from dashboard - What: Extensions with view-type commands must include a metadata/ folder containing Raycast-styled... (source)

- Resize metadata screenshots to 2000x1250
- Add metadata screenshots and fix CHANGELOG date format
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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants