convez.ai
AgenteProdutividadeIntermediário
raya-ac

Kiln

raya-ac/kiln

App nativo Mac para agent CLIs com editor integrado e sessões por projeto

Ver no GitHub
BomPluginScore · de 0 a 100

Aplicativo nativo macOS que encapsula agent CLIs como Claude Code e Codex em uma interface desktop moderna. Oferece sessões por projeto, editor integrado, command palette e aprovações em diálogos reais, eliminando a necessidade de abas de terminal adicionais.

Instalação

$npx convez-ai raya-ac/kiln

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 3 dias
Versão
v1.9.3
Issues abertas
0
Contribuidores
2

Casos de uso

  • Executar Claude Code ou Codex com interface de desktop nativa
  • Gerenciar múltiplas sessões de agentes por projeto com sidebar organizada
  • Visualizar diffs inline de edições do agente e aprovar/revert mudanças
  • Controlar agentes remotamente via túneis Cloudflare desde outro dispositivo

Veredito

Kiln é uma solução bem executada para quem usa agent CLIs no macOS. A integração com editor, git-awareness e comando palette resolvem dores reais do workflow terminal, mas ainda está em desenvolvimento ativo — recomendado para early adopters acostumados com ferramentas em evolução.

README

A tradução para o português deste README ainda está na fila.

Kiln runs agent CLIs as a proper desktop app instead of another terminal tab. Sessions live in a sidebar, approvals pop up as real dialogs, and the whole thing feels like the rest of your Mac. Built in SwiftUI. macOS 14 or later, Apple Silicon or Intel.

Why

I wanted the feel of a native editor — command palette, keyboard shortcuts, a sidebar — without giving up the CLI workflow underneath. So Kiln wraps the agent CLI, keeps a session per project, and adds the stuff that's awkward to do in a terminal: per-session tunnels, remote control from another device, real video/image previews, clean export.

It's still early. I use it every day; you might want to wait.

What's in it

  • Sessions per project, code and chat split into two sidebars.
  • Command palette (⌘K), Quick Open (⌘P), global message search (⇧⌘F).
  • Built-in editor with inline agent edit diffs (accept / revert), breadcrumbs, and keyboard shortcuts.
  • Git-aware file tree — per-file status markers, directory roll-up, branch pill in the workdir header, "Show Diff vs HEAD" on any modified file, and "Ask About This File" right from the context menu.
  • Workdir activity chip above the composer — shows what the active agent's tools touched since HEAD, click a row for the diff. Event-driven, no polling.
  • Claude sessions keep working when you move their workdir — the underlying CLI conversation file is migrated into the new project dir so context carries across the move. Codex sessions currently start fresh after a workdir change.
  • ~60 local slash commands for git, repo inspection, clipboard/export, and quick session ops — typed right in the composer.
  • Cmd+Opt+1..9 to jump to the Nth visible session in the current tab.
  • 16 languages in Settings with full UI translations — English, German, Chinese, French, Spanish, Japanese, Italian, Portuguese, Russian, Korean, Dutch, Hindi, Arabic, Polish, Turkish, Swedish.
  • Per-session Cloudflare tunnels for remote control from your phone.
  • Real approval dialogs for Claude sessions instead of terminal prompts.
  • Dock icon that live-tints to your accent color and follows dark mode.
  • Sparkle auto-updates.

Running it

Clone and build:

git clone https://github.com/raya-ac/kiln
cd kiln
swift build -c release
open .build/release/Kiln

That gets you the raw binary. To produce a real Kiln.app bundle (the kind Finder recognises, with auto-updates wired up):

./scripts/make-app-bundle.sh 1.9.1 arm64      # Apple Silicon
./scripts/make-app-bundle.sh 1.9.1 x86_64     # Intel
open dist/arm64/Kiln.app

Either works fine for trying it out.

Releases & auto-updates

Push a tag like v1.9.1 and GitHub Actions will:

  1. Build separate Apple Silicon and Intel .app bundles.
  2. Code-sign and notarise them (if you've added the Apple secrets).
  3. Sign both zips with Sparkle's EdDSA key.
  4. Regenerate appcast.xml — Sparkle reads the binary of each zip and stamps the correct architecture on the feed item, so each Mac pulls the build that matches it.
  5. Commit the new appcast.xml back to main and publish a GitHub release with both zips attached.

Inside the app, Kiln → Check for Updates… hits that appcast. Scheduled checks run once a day.

Setting up releases

If you're forking this, you'll need a few secrets on your repo at Settings → Secrets and variables → Actions.

For Sparkle (required for auto-updates to actually verify):

SecretWhy
SPARKLE_ED_PRIVATE_KEYSigns the update zips. Keep it safe.
SPARKLE_ED_PUBLIC_KEYEmbedded in the app so it can verify updates came from you.

Generate the pair once:

curl -LO https://github.com/sparkle-project/Sparkle/releases/download/2.6.4/Sparkle-2.6.4.tar.xz
tar -xJf Sparkle-2.6.4.tar.xz
./bin/generate_keys       # adds private key to your Keychain; prints the public half
./bin/generate_keys -x    # prints the private key — base64 it for the GH secret

For Apple code-signing and notarisation (optional — leave blank and the workflow skips these steps, but users will see a Gatekeeper warning on first launch):

SecretWhy
APPLE_CERT_P12Your Developer ID Application cert exported as a .p12, base64-encoded.
APPLE_CERT_P12_PASSWORDPassword you set on the .p12.
APPLE_CODESIGN_IDENTITYe.g. Developer ID Application: Your Name (TEAMID).
APPLE_API_KEY_P8App Store Connect API key for notarytool, base64-encoded.
APPLE_API_KEY_IDThe 10-char key ID.
APPLE_API_ISSUER_IDIssuer UUID from App Store Connect.

Layout

Sources/
  App/          entry point, AppDelegate
  Views/        SwiftUI views — sidebar, chat, settings
  Services/     AppStore, Claude/Codex backends, remote control, tunnels, updater
  Models/       domain types
scripts/        make-app-bundle.sh + entitlements
.github/        CI + release workflows

Development shortcuts

Common commands are wrapped in a Makefile:

make           # lists everything
make run       # debug build + open the binary
make bundle VERSION=1.9.1 ARCH=arm64
make lint      # swift-format --lint
make format    # swift-format --in-place
make logo      # re-render the brand mark
make ci-local  # run everything CI runs, locally

Contributing

It's a personal project but PRs are welcome. Build with swift build, run with open .build/debug/Kiln (or the release variant), and the CI workflow will catch the obvious stuff. See CONTRIBUTING.md for the shape of a good patch and CODE_OF_CONDUCT.md for how we behave in issues and PRs.

Security issues: please don't file them as public issues — see SECURITY.md.

Licence

MIT.

Ver o original no GitHub

Bom para

Relacionados