perspective-cuts - GitLite

KO | EN

gitlite — search

#javascript #ai #typescript #llm #golang #machine-learning #deep-learning #linux #docker #macos #java #awesome-list #pytorch #mcp

perspective-cuts

(★ 177)

A text-based language for writing Apple Shortcuts. Experimental.

파일 탐색기

최종 버전 다운로드 (.zip)

- FUNDING.yml
- compile.gif
- compile.tape
- discover.gif
- discover.tape
- hero.gif
- hero.tape
- install-demo.tape
- install.gif
- action-test-suite.perspective
- battery-alert.perspective
- chatgpt-ask.perspective
- clipboard-ai.perspective
- define-word.perspective
- dictionary-test.perspective
- full-test-suite.perspective
- hello-world.perspective
- morning-briefing.perspective
- perspective-ai-chat.perspective
- quick-note.perspective
- substack-summarizer.perspective
- translate-test.perspective
.gitignore
CONTRIBUTING.md
LICENSE
Package.resolved
Package.swift
PERSPECTIVE-LANGUAGE.md
README.md
SECURITY.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/taylorarndt/perspective-cuts

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd perspective-cuts

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Homebrew macOS/Linux용 패키지 매니저입니다.

brew tap taylorarndt/tap

Homebrew에 이 프로젝트의 저장소(tap)를 등록합니다.

brew install perspective-cuts

Homebrew로 이미 빌드된 패키지를 바로 설치합니다. 소스 빌드가 필요 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Perspective Cuts

A text-based language for writing Apple Shortcuts. Write code, compile it, get a shortcut. No dragging blocks. No clicking menus. Just text.

<p align="center">
  <img src="demos/hero.gif" alt="Terminal demo showing Perspective Cuts compiling a shortcut, listing actions, and discovering third-party app actions" width="800">
</p>

**This is a highly experimental project.** Things will break. APIs will change. Actions might not work on your machine. If you are okay with that, keep reading.

## Why I Built This

I wanted an easy and accessible way to create shortcuts through code. The Shortcuts app is visual. It is drag and drop. That does not work for everyone. I wanted to write shortcuts the same way I write Swift code. In a text editor. With a compiler that handles the rest.

If you know my stance on using Apple official channels, you know where this is going. Perspective Cuts is built in Swift. It uses Swift Package Manager. It runs on macOS. And it uses Apple's own `shortcuts sign` command to sign the output. That is the tool Apple ships with macOS for signing shortcut files. I am not using some third party signing service. I am not wrapping this in Electron or shipping it as a web app. This is a Mac tool for building Apple Shortcuts. Built the right way.

Other tools existed for writing shortcuts as code. JellyCuts was the main one. But the actions were outdated. It did not support iOS 26 actions like Apple Intelligence, Private Cloud Compute, or the new Writing Tools. It did not support third party apps out of the box. I wanted to provide a solution that was current, that supported every action Apple ships, and that could use any app installed on your Mac without having to register anything.

## What It Does

- 180+ built-in Shortcuts actions with friendly parameter names
- Any third party app action via raw identifiers (ChatGPT, Drafts, Fantastical, Bear, Things, etc.)
- Apple Intelligence with Private Cloud Compute and on-device models
- Translation to 21 languages
- Control flow (if/else, repeat, for-each, menu)
- Compiles to signed `.shortcut` files that work on macOS, iOS, and iPadOS
- `discover` command to find actions from any installed app

## Install

<img src="demos/install.gif" alt="Terminal demo showing Homebrew install, discovering third-party actions, inspecting ChatGPT action parameters with the detail command, and compiling a shortcut" width="800">

```bash
brew tap taylorarndt/tap
brew install perspective-cuts
```

Or build from source:

```bash
git clone https://github.com/taylorarndt/perspective-cuts.git
cd perspective-cuts
swift build
```

## Quick Start

```bash

# Write a shortcut
cat > hello.perspective << 'EOF'
import Shortcuts
#color: blue
#icon: star
#name: Hello World

text(text: "Hello from Perspective Cuts!") -> greeting
showResult(text: greeting)
EOF

# Compile and sign
swift run perspective-cuts compile --sign hello.perspective

# Import into Shortcuts
open hello.shortcut
```

## Example: Substack Summarizer with Private Cloud Compute

<img src="demos/compile.gif" alt="Terminal demo compiling a Substack Summarizer shortcut with Private Cloud Compute" width="800">

```
import Shortcuts
#color: purple
#icon: compose
#name: Taylors Substack Summarizer

getRSSFeed(url: "https://taylorarndt.substack.com/feed", count: 5) -> feedItems
useModel(prompt: "Summarize each of these blog posts in 3 key bullet points:\n\(feedItems)", model: "Private Cloud Compute", resultType: "Automatic", followUp: false) -> summary
showResult(text: summary)
```

## Example: Third Party App (ChatGPT)

```
import Shortcuts
#color: green
#icon: message
#name: Ask ChatGPT

ask(prompt: "What do you want to ask ChatGPT?") -> question
com.openai.chat.AskIntent(prompt: question) -> answer
showResult(text: answer)
```

## CLI

<img src="demos/discover.gif" alt="Terminal demo showing the discover command finding third-party app actions" width="800">

```bash
perspective-cuts compile --sign file.perspective    # Compile and sign
perspective-cuts compile --install file.perspective  # Install to Shortcuts DB
perspective-cuts actions                             # List built-in actions
perspective-cuts discover openai                     # Find third party actions
perspective-cuts discover --third-party              # All third party apps
perspective-cuts detail com.openai.chat.AskIntent   # Inspect action parameters
perspective-cuts validate file.perspective           # Validate syntax
```

## macOS Only

This runs on macOS only. The `shortcuts sign` command that Apple provides only exists on Mac. If Apple ever ships a signing tool on iOS, I will add support. But I am not going to use unofficial signers. That is not how I do things.

## Full Documentation

See [PERSPECTIVE-LANGUAGE.md](PERSPECTIVE-LANGUAGE.md) for the complete language reference, 12 tutorials, all 180+ actions, AI assistant instructions, and verified test results.

## Status

This is experimental. 35 actions have been tested end-to-end. 167 have verified identifiers. The compiler works. The language works. But there are known limitations:

- `changeCase` cannot be used because `case` is a parser keyword
- `getCurrentWeather` is iOS only
- Some enum parameters need special handling (like `useModel` needing integer values)
- 13 legacy actions have unverified identifiers

See the full list in the language reference.

## Security

See [SECURITY.md](SECURITY.md) for the security policy and how to report vulnerabilities.

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for how to contribute. This is experimental. I appreciate help but want to make sure contributions align with where the project is going.

## AI Contributions Are Welcome

AI-generated contributions are welcome here. You do not need to apologize for your tooling.

We use AI on this project ourselves. The way we like to work is what we call partner coding. A human and an AI write code together, and a human reviews what comes out. If you have a basic understanding of what the code does and why, we are very happy to work with you on it. And honestly, even if you do not fully understand every line yet, we are still willing to review it with you. We believe in helping people learn how to code and in building a community around that, not gatekeeping based on how the keystrokes got typed.

No PRs will be closed here for being AI-assisted. Bring them.

## Contributors

<table>
  <tbody>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/taylorarndt"><img src="https://github.com/taylorarndt.png?size=100" width="100px;" alt="Taylor Arndt"/><br /><sub><b>Taylor Arndt</b></sub></a><br />Creator</td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/mikedoise"><img src="https://github.com/mikedoise.png?size=100" width="100px;" alt="Michael Doise"/><br /><sub><b>Michael Doise</b></sub></a><br />Contributor</td>
    </tr>
  </tbody>
</table>

## License

MIT