Helm - Cliente macOS para Claude Code e Codex
BD777/helm
Interface SwiftUI para Claude Code/Codex com perfis, SSH e automação de projetos
Ver no GitHubCliente nativo macOS que oferece uma interface unificada para trabalhar com sessões Claude Code e Codex em projetos locais e remotos via SSH. Inclui suporte a perfis, streaming de chat com renderização de tool calls, diffs e blocos de raciocínio, além de workflows de Project Inbox para orquestração de tarefas.
Instalação
npx convez-ai BD777/helm1 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
Casos de uso
- Gerenciar múltiplas sessões de Claude Code em projetos locais e remotos
- Organizar e retomar sessões de desenvolvimento com perfis customizados
- Executar workflows de Project Inbox para orquestração automática de tarefas
- Revisar diffs, approvals e blocos de raciocínio em tempo real
Veredito

Helm é um cliente macOS bem-estruturado (pré-1.0) para workflows Claude Code/Codex, ideal para desenvolvedores que precisam gerenciar projetos remotos via SSH. Requer compilação manual por enquanto, mas oferece integração nativa com perfis, streaming e automação de tarefas — útil para quem quer escapar do terminal.
README
A tradução para o português deste README ainda está na fila.
Helm
Helm is a native macOS client for working with Claude Code and Codex sessions across local and SSH projects.

It is intentionally a thin SwiftUI shell over the vendor CLIs and SDKs. Agent
transcripts, auth, and config live on the machine running the agent: local
~/.codex / ~/.claude for local projects, or the remote SSH host for remote
projects. Helm keeps only app state, profile metadata, and restorable session
indexes in its own app support directory.
Status
Pre-1.0 and moving quickly. Expect data shapes, settings, and UI details to change while the project settles. Public users should build from source for now; downloadable binaries still need a signed and notarized release flow.
Security note: provider tokens configured inside Helm are currently stored in plaintext app support JSON files. Do not share app state, transcripts, logs, or screenshots without reviewing them for sensitive data.
Features
- Single-window macOS UI for local and SSH projects.
- Claude and Codex profiles with separate providers, models, environment overlays, and command paths.
- Session creation, resume, rename, archive, and project-level organization.
- Streaming chat rendering with tool calls, approvals, diffs, reasoning blocks, image attachments, and Markdown.
- Per-session runtime controls such as model, profile, sandbox, approval mode, and reasoning effort.
- Project Inbox workflow support for task orchestration inside Helm.
Helm is not affiliated with Anthropic, OpenAI, or the Kubernetes Helm project.
Requirements
- macOS 15 or newer.
- Xcode with the macOS SDK installed.
- Git.
- Claude Code and/or Codex installed and authenticated if you want to run those providers.
The Xcode project is checked in. project.yml is also kept as the source of
truth for regenerating the project when desired.
Build
git clone https://github.com/BD777/helm.git
cd helm
xcodebuild -project Helm.xcodeproj \
-scheme Helm \
-configuration Debug \
-derivedDataPath build/DerivedData \
build
open build/DerivedData/Build/Products/Debug/Helm.app
For a local release-style rebuild and install, run:
./rebuild-helm-app.command
That script fetches the configured remote branch, builds a Release app, and
installs it into /Applications by default. It may quit a running Helm app
before replacing it.
Before opening a pull request or publishing a release, run:
./scripts/open-source-scan.sh
git diff --check
Layout
Helm/- SwiftUI app source.Helm.xcodeproj/- checked-in Xcode project.project.yml- XcodeGen project definition.design/- early mockups and UI notes.docs/- public architecture, development, and privacy notes..claude/skills/- optional project workflow skill used by Helm Project Inbox integrations.
Documentation
- Architecture
- Development
- Privacy and Data Handling
- Release Notes
- Contributing
- Security
- Code of Conduct
- Third Party Notices
License
MIT. See LICENSE.