convez.ai
AgenteProdutividadeAvançado
huangguang1999

Baozi — Cliente remoto para agentes de IA

huangguang1999/baozi

Controle agentes de IA do seu telefone via Mac, sem nuvem.

Ver no GitHub
InicialPluginScore · de 0 a 100

Cliente nativo iOS e Android que controla remotamente agentes de IA (Codex, Claude) rodando no seu Mac. Conecta smartphone com daemon leve no computador para gerenciar sessões, fazer streaming de saída e executar workflows de codificação agentica on-the-go, com criptografia ponto-a-ponto.

Instalação

$npx convez-ai huangguang1999/baozi

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
3
Forks
1
Acompanhando
0
Saúde
57%
Último commit
há 5 meses
Versão
android-v1.5.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Programação remota com Codex/Claude do smartphone
  • Gerenciamento de sessões e debugging de agents em tempo real
  • Workflows de desenvolvimento mobile com controle descentralizado

Veredito

Projeto experimental bem arquitetado: Rust compartilhado entre plataformas via UniFFI, UI thin em Swift/Kotlin, P2P criptografado sem dependência de cloud. Ainda em beta (iOS em review, Android APK manual), público niche de devs que querem agentic coding mobile com soberania de dados.

README

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

包子

Screenshots (iOS)

Download

  • iOS — TestFlight / App Store (in review)
  • Android — download the latest APK (arm64, direct install; enable "unknown sources"). Not on Google Play.
  • Your computer — run the daemon: npx baozicli (see below)

Quick Start

make ios-device-fast   # fast device build
make ios-sim-fast      # fast simulator build
make android-emulator-fast  # fast Android emulator build

Fresh Checkout Prerequisites

After pairing a new Apple Watch with Xcode (Window → Devices and Simulators), run this once so CLI builds can install BaoziWatch on it:

make watch-register

This registers the watch UDID with Apple's developer portal and refreshes the provisioning profile. Without it, xcodebuild succeeds but devicectl ... install app fails with "App could not be installed at this time". The target is idempotent (stamped per-UDID under .build-stamps/), so re-runs are no-ops until a new watch is paired. Override discovery with WATCH_UDID=<udid> if auto-detection fails.

See docs/DEVELOPMENT.md for prerequisites, full build options, TestFlight/App Store release, and SSH setup.

Repository Layout

apps/ios/                  iOS app (Baozi scheme, project.yml is source of truth)
apps/android/              Android app (Compose UI, Gradle build)
shared/rust-bridge/
  codex-mobile-client/     Shared Rust client crate + UniFFI surface (iOS & Android)
  codex-ios-audio/         iOS-only audio/AEC crate
shared/third_party/codex/  Upstream Codex submodule
patches/codex/             Local patch set applied during builds
tools/scripts/             Cross-platform helper scripts

Architecture

Both platforms share a single Rust core (codex-mobile-client) via UniFFI-generated bindings. Platform code (Swift/Kotlin) stays thin: UI, permissions, notifications, and platform APIs only. Session state, streaming, hydration, discovery, and auth logic live in Rust.

Connecting Your Mac

包子 drives agents that run on your own computer — the app is the remote, your Mac does the work. Run the daemon on the Mac, then pair it from the app over an end-to-end-encrypted P2P link (no account, no cloud relay of your code):

npx baozicli      # the Mac daemon, published from services/kittylitter (binary: baozi)

The app discovers the daemon on your LAN automatically; you can also pair manually or over SSH. Bring your own API key — there is no hosted login.

Contributing

包子 is under active development and a lot of features are in flight. PRs are welcome but will likely only be merged if they're small and target a specific problem — sweeping refactors and new features tend to collide with work already underway. See CONTRIBUTING.md before opening one.

License

包子 is licensed under the GNU General Public License version 3 with an additional permission under GPLv3 section 7 for Apple App Store and Google Play distribution. See LICENSE.

包子 is a rebranded fork of the open-source litter project — the kittylitter daemon and alleycat P2P transport by @dnakov, also GPLv3.

Make Targets

TargetDescription
make ios-device-fastFast device build (raw staticlib)
make ios-sim-fastFast simulator build
make iosFull package lane (device + sim + xcframework)
make android-emulator-fastFast Android emulator build
make androidFull Android pipeline
make rust-checkHost cargo check for shared Rust crates
make rust-testHost cargo test for shared Rust crates
make bindingsRegenerate UniFFI Swift + Kotlin bindings
make xcgenRegenerate Xcode project from project.yml
make watch-registerRegister a newly paired Apple Watch with the developer portal (idempotent)
make cleanRemove all build artifacts
Ver o original no GitHub

Bom para

Relacionados