Como usar o Raycast para automações de produtividade no Mac

1. Introdução ao Raycast como Plataforma de Automação

O Raycast é muito mais que um simples launcher de aplicativos. Ele funciona como uma plataforma completa de automação para macOS, permitindo que usuários executem tarefas complexas com poucas teclas. Diferentemente do Alfred, que exige configurações manuais extensas, ou dos atalhos nativos do macOS, que são limitados em escopo, o Raycast oferece um ecossistema integrado de extensões, snippets e scripts que podem ser combinados para criar fluxos de trabalho poderosos.

O diferencial do Raycast está na sua arquitetura extensível. Enquanto o Spotlight nativo apenas localiza arquivos e aplicativos, o Raycast permite executar comandos personalizados, consultar APIs, gerenciar snippets e até controlar outras ferramentas como VS Code, Git e Notion. Para quem trabalha com múltiplos projetos e precisa de automações rápidas, essa flexibilidade é essencial.

2. Configuração Inicial e Atalhos Essenciais

A instalação do Raycast é direta pelo site oficial, mas a verdadeira personalização começa nos atalhos de teclado. Recomendo substituir o atalho padrão Command+Space pelo Option+Space para evitar conflitos com o Spotlight.

# Configuração de atalho global no Raycast
1. Abra Raycast Preferences
2. Navegue até General > Hotkey
3. Pressione Option+Space para definir o novo atalho
4. Desative o Spotlight antigo em System Settings > Keyboard > Keyboard Shortcuts

Para navegação eficiente, aprenda estes comandos essenciais:
- Command+K: abrir busca de comandos
- Command+N: criar novo snippet ou script
- Command+P: pesquisar em arquivos abertos
- Command+Shift+P: abrir paleta de comandos do projeto atual

3. Automações com Snippets e Expansão de Texto

Os snippets no Raycast vão além da simples expansão de texto. Eles suportam placeholders dinâmicos, datas formatadas e até scripts embutidos. Organize seus snippets por pastas temáticas para manter a produtividade.

# Exemplo de snippet para data de reunião
Trigger: ;meeting
Template: Reunião de alinhamento em {date:dd/MM/yyyy} às {time:HH:mm}
Placeholders: 
  - {date:dd/MM/yyyy} → insere data atual
  - {time:HH:mm} → insere horário atual
  - {clipboard} → insere conteúdo da área de transferência

Para sincronizar snippets entre múltiplos Macs, ative o iCloud nas configurações do Raycast:

# Ativar sincronização iCloud
1. Raycast Preferences > Extensions > Snippets
2. Ative "Sync Snippets via iCloud"
3. Os snippets serão compartilhados automaticamente entre dispositivos

4. Script Commands: Automações Customizadas em Bash, Python e AppleScript

Os Script Commands são a espinha dorsal das automações no Raycast. Eles permitem executar scripts em qualquer linguagem suportada pelo macOS. Vamos criar um script para renomear arquivos em lote:

#!/bin/bash
# Required parameters:
# @raycast.schemaVersion 1
# @raycast.title Renomear Arquivos em Lote
# @raycast.mode silent
# @raycast.packageName File Management

# Optional parameters:
# @raycast.icon 📁
# @raycast.argument1 { "type": "text", "placeholder": "Prefixo" }
# @raycast.argument2 { "type": "text", "placeholder": "Sufixo" }

cd "$(dirname "$0")"
for file in *; do
  if [ -f "$file" ]; then
    extension="${file##*.}"
    newname="${1}_${file%.*}_${2}.${extension}"
    mv "$file" "$newname"
  fi
done
echo "Arquivos renomeados com sucesso!"

Para consultar APIs diretamente do Raycast:

#!/usr/bin/env python3
# @raycast.schemaVersion 1
# @raycast.title Consultar Clima
# @raycast.mode compact
# @raycast.packageName Weather

import requests
import json

cidade = "São Paulo"
url = f"https://wttr.in/{cidade}?format=%C+%t"
response = requests.get(url)
print(f"Clima em {cidade}: {response.text}")

5. Extensões Avançadas para Produtividade Técnica

O Raycast oferece extensões nativas para ferramentas de desenvolvimento. A integração com VS Code permite abrir projetos rapidamente:

# Comandos úteis da extensão VS Code
- "Open Project" → lista projetos recentes do VS Code
- "Run Task" → executa tasks configuradas no workspace
- "Search in Project" → busca arquivos dentro do projeto atual

Para automação com Git, a extensão oficial oferece:

# Fluxo de commit rápido com Raycast
1. Command+Space → digite "Git Commit"
2. Selecione os arquivos modificados
3. Digite a mensagem de commit
4. Pressione Enter para confirmar

# Navegação entre branches
1. Command+Space → digite "Git Switch"
2. Digite o nome do branch
3. Pressione Enter para alternar

Quicklinks permitem criar atalhos para URLs frequentes. Para criar um quicklink que abre uma pasta específica:

# Criando Quicklink para pasta de projetos
1. Raycast Preferences > Extensions > Quicklinks
2. Clique em "Create Quicklink"
3. Name: "Projetos Ativos"
4. URL: file:///Users/seunome/Projetos
5. Trigger: ;projetos

Deeplinks integram o Raycast com outras ferramentas. Para abrir uma nota específica no Obsidian:

# Deeplink para Obsidian
obsidian://open?vault=MeuVault&file=Notas/Reuniões/2024-01-15

# Uso no Raycast
1. Crie um Quicklink com a URL acima
2. Atribua um trigger como ;reuniao
3. Ao digitar ;reuniao, a nota será aberta automaticamente

7. Dicas de Manutenção e Otimização da Lista de Temas

Para manter sua coleção de scripts e snippets organizada, crie um repositório Git dedicado:

# Estrutura de repositório para scripts
raycast-scripts/
├── snippets/
│   ├── desenvolvimento/
│   │   ├── git-commit.json
│   │   └── docker-compose.json
│   └── pessoal/
│       ├── endereco.json
│       └── telefone.json
├── scripts/
│   ├── bash/
│   └── python/
└── config/
    └── raycast-config.json

Para backup completo da configuração:

# Exportar configuração do Raycast
1. Raycast Preferences > Advanced
2. Clique em "Export Configuration"
3. Salve o arquivo .rayconfig em local seguro
4. Para importar: File > Import Configuration

Estratégias para evitar sobrecarga:
- Limite o número de snippets ativos a 20 por categoria
- Use triggers curtos (2-3 caracteres) para comandos frequentes
- Revise mensalmente scripts não utilizados
- Mantenha documentação inline nos scripts

Referências