PHPackages                             cloudatlas/flyclone - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. cloudatlas/flyclone

Abandoned → [https://github.com/verseles/flyclone](/?search=https%3A%2F%2Fgithub.com%2Fverseles%2Fflyclone)Library[File &amp; Storage](/categories/file-storage)

cloudatlas/flyclone
===================

PHP wrapper for rclone

9077917[13 issues](https://github.com/verseles/codewalk/issues)DartCI passing

Since Feb 8Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/verseles/codewalk)[ Packagist](https://packagist.org/packages/cloudatlas/flyclone)[ RSS](/packages/cloudatlas-flyclone/feed)WikiDiscussions main Synced 4w ago

READMEChangelog (10)Dependencies (6)Versions (51)Used By (0)

CodeWalk
========

[](#codewalk)

[![CodeWalk desktop demo](demo-desktop.gif)](demo-desktop.gif)

    demo-mobile.mp4    [![CodeWalk Logo](assets/images/logo.256.png)](assets/images/logo.256.png)

A native (really fast!!) cross-platform client for [OpenCode](https://github.com/anomalyco/opencode) server mode. Built with Flutter, it provides a conversational interface for session-based AI coding interactions over HTTP APIs and streaming events.

Unique Features
---------------

[](#unique-features)

- 🌐 Fully translated into 14 languages: English, Português (Brasil), Español, Deutsch, Français, Italiano, Русский, 中文, 日本語, 한국어, हिन्दी, বাংলা, العربية, اردو
- 🎙 Speech-to-text on every platform, including Linux
- 🔊 Text-to-speech read-aloud for assistant messages
- 📊 Host quota monitoring through official/OpenChamber REST when available, plus shell fallback probes for Claude, OpenRouter, Codex/OpenAI, Gemini, GitHub Copilot, OpenCode Go, NanoGPT, Wafer, Kimi, ZhipuAI, MiniMax, z.ai, Cursor, and Ollama Cloud
- 📈 Inline Mermaid diagram rendering from fenced markdown blocks
- 💬 Canned answers for faster replies
- ↩️ Easier undo and redo
- 🧙 OpenCode setup wizard
- 🔢 LaTeX math rendering — typeset inline and block equations via pure-Dart KaTeX port
- 📤 Share messages as images — export any chat message as a themed PNG with native share
- 🔐 Cloudflare Access OAuth — PKCE-based auth for servers behind Cloudflare Access
- 📋 Session export as Markdown/JSON — full conversation export with paginated loading
- 🖥 Server-hosted PTY terminal — embedded terminal running on the OpenCode host
- ↩️ Inline revert to any prior turn — undo with draft restoration via official revert endpoint

Highlights
----------

[](#highlights)

- Realtime AI chat with streaming responses (SSE) and robust turn reconciliation
- Queued `Send now` handoff without false abort error noise or duplicate chat bubbles
- Instant session reopen with cached grouped history, direct bottom landing, and background delta-style revalidation
- Load older message history by scrolling to the top of chat
- Project-centric sidebar with conversations grouped by open projects
- Context-scoped conversation pinning to keep priority sessions at top
- Canned answers with global/project scope
- Project context support for both Git repositories and non-Git folders
- Per-project New Chat draft isolation with lazy session bootstrap
- Multi-server profile management (health checks, default/active switching, auth)
- Install and Run OpenCode Server directly from Settings
- Model/provider selection with variants, favorites, and reasoning controls
- In-app update flow with auto-check, startup notification, and direct install
- Physical-keyboard productivity shortcuts, including Alt+Tab-style session cycling
- Mobile external-keyboard send keeps composer focus for rapid follow-up input
- Interactive server permission/question prompts with attention badges
- Responsive Material 3 experience across Linux, Windows, macOS, Web, and Android
- 14-language support with instant language switching, system-default detection, and RTL layout for Arabic and Urdu
- Text-to-speech read-aloud for assistant responses with adjustable speed and pitch
- Mermaid diagram rendering from fenced code blocks with copy-source fallback
- Density-aware UI with 5 spacing tiers (compact → spacious) across chrome and composer
- Smart session state restore — re-selects last agent/model/variant from message metadata
- Reactive notification dismissal — auto-clears on SSE events, no stale alerts
- Rich diff review surface with syntax highlighting, line gutters, and lazy hunk loading
- Cloudflare Access OAuth with PKCE for secure enterprise reverse-proxy auth
- Server-hosted PTY terminal streamed to client for in-app command-line access

Install in One Command
----------------------

[](#install-in-one-command)

Install using the `install.cat` pattern:

- Linux &amp; macOS

    ```
    curl -fsSL install.cat/verseles/codewalk | sh
    ```
- Windows (PowerShell)

    ```
    irm install.cat/verseles/codewalk | iex
    ```

Run the same command again any time to update/reinstall to the latest GitHub release.

Installers automatically pick the right release for your platform.

- Android

    Open this in your Android browser to download the APK: [install.cat/verseles/codewalk](https://install.cat/verseles/codewalk)

### Uninstall

[](#uninstall)

- Linux &amp; macOS

    ```
    curl -fsSL https://raw.githubusercontent.com/verseles/codewalk/main/uninstall.sh | sh
    ```
- Windows (PowerShell)

    ```
    irm https://raw.githubusercontent.com/verseles/codewalk/main/uninstall.ps1 | iex
    ```

Getting Started
---------------

[](#getting-started)

### Prerequisites

[](#prerequisites)

- Flutter SDK (&gt;=3.8.1)
- Dart SDK
- An OpenCode-compatible server instance
- Platform toolchain for your target:
    - Linux desktop: `clang`, `cmake`, `ninja`, `pkg-config`
    - Windows desktop: build from a Windows host
    - macOS desktop: build from a macOS host

### Setup

[](#setup)

1. Install dependencies:

    ```
    flutter pub get
    ```
2. Run the app (examples):

    ```
    flutter run -d linux
    flutter run -d chrome
    flutter run -d android
    ```
3. Build artifacts (examples):

    ```
    flutter build linux
    flutter build web
    ```

### Make Targets

[](#make-targets)

```
make check      # deps + codegen + analyze + test
make check-fast # deps + codegen + analyze + test-fast
make test-fast  # excludes slow/integration tags
make web        # build Flutter web app into build/web
make android    # build arm64 APK
make release V=patch # bump pubspec, update CHANGELOG.md, commit, tag, push
```

Use `make check` for normal validation. When you need a testable Android artifact, run `HEY_CAPTION="specific caption" make android` after checks pass.

### Web Deploy: Cloudflare Pages or Static Hosting

[](#web-deploy-cloudflare-pages-or-static-hosting)

CodeWalk's web build is a static Flutter app. The build does not need Cloudflare secrets or compile-time OpenCode credentials; users add their OpenCode server profile inside the app after opening the deployed site.

1. Build the web app:

    ```
    make web
    ```

    This runs `flutter build web --release --base-href "/"` and writes the static site to `build/web`.
2. For a subpath deployment, set a base href that starts and ends with `/`:

    ```
    WEB_BASE_HREF="/codewalk/" make web
    ```
3. Preview the static output locally for root-hosted builds:

    ```
    python3 -m http.server 8080 --directory build/web
    ```

    If you build with a subpath `WEB_BASE_HREF`, preview it under the same path prefix; otherwise browser asset URLs will not match the local server root.
4. Publish `build/web` to Cloudflare Pages.

    Direct upload with Wrangler:

    ```
    npx wrangler pages deploy build/web --project-name codewalk
    ```

    Cloudflare Pages Git settings, if your Pages build image has Flutter available:

    ```
    Build command: make web
    Build output directory: build/web
    Root directory: (leave blank)

    ```
5. Configure the OpenCode server that the browser app will connect to. For a Pages deployment at `https://your-codewalk.pages.dev`, allow that exact origin:

    ```
    export OPENCODE_SERVER_PASSWORD="choose-a-password"
    opencode serve --hostname 0.0.0.0 --port 4096 --cors "https://your-codewalk.pages.dev"
    ```
6. Add a CodeWalk server profile in the web app using your reachable server URL and Basic Auth credentials.

Known limitations:

- An HTTPS-hosted CodeWalk site cannot call a plain HTTP OpenCode server on a LAN IP because browsers block mixed content. Use HTTPS for the OpenCode origin, a trusted reverse proxy/tunnel, or run the CodeWalk web build from a local HTTP origin during private testing.
- CORS must allow the exact CodeWalk origin when Basic Auth or other credentials are used; do not rely on wildcard CORS for authenticated browser requests.
- The OpenCode server URL must be reachable from the user's browser, not from Cloudflare's build system.

### Server Configuration

[](#server-configuration)

1. Launch the app and open **Settings** from the sidebar
2. Tap **Add Server** and run the Quick setup command in your terminal
3. Keep the default `Server URL` (`http://127.0.0.1:4096`) or set your server URL
4. Configure Basic Auth only if your server requires it
5. Save and switch active/default profiles as needed

### OpenCode Project Agent

[](#opencode-project-agent)

When you run OpenCode from this repository, the repo ships a project agent at `.opencode/agents/opencodeNews.md`:

- `@opencodeNews` reviews the latest OpenCode release for CodeWalk impact
- `@opencodeNews review vX.Y.Z` or `@opencodeNews check https://github.com/anomalyco/opencode/releases/tag/...` reviews a specific release target mentioned in the same prompt

The agent returns a release summary, impact/risk by area, proposed adjustments, and an execution plan only when CodeWalk work is needed.

Architecture
------------

[](#architecture)

The project follows Clean Architecture with three layers: Domain, Data, and Presentation. Dependency injection via `get_it`, HTTP via `dio`, state management via `provider`.

For the ADR-023 compatibility baseline and current OpenCode contract inventory, see [CONTRACT\_MATRIX.md](CONTRACT_MATRIX.md).

For full technical details, see [CODEBASE.md](CODEBASE.md).

Tech Stack
----------

[](#tech-stack)

- **Framework:** Flutter
- **Language:** Dart
- **State Management:** Provider
- **HTTP Client:** Dio
- **Local Storage:** SharedPreferences
- **Dependency Injection:** GetIt
- **Design System:** Material Design 3

License
-------

[](#license)

This project is dual-licensed:

- **Open Source:** [GNU Affero General Public License v3.0 (AGPLv3)](LICENSE) -- free for everyone.
- **Commercial:** A [separate commercial license](LICENSE-COMMERCIAL.md) is available for organizations with annual revenue exceeding USD 1M that wish to use the software without AGPLv3 obligations.

Origin and Acknowledgment
-------------------------

[](#origin-and-acknowledgment)

CodeWalk is a fork of [OpenMode](https://github.com/easychen/openMode), originally created by [easychen](https://github.com/easychen). The original project is licensed under MIT.

Substantial modifications have been made since the fork, including licensing changes, code restructuring, rebranding, full English standardization, and documentation rewrites. All modifications are licensed under AGPLv3 (or the commercial license, where applicable).

See [NOTICE](NOTICE) for full attribution details.

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance59

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity28

Early-stage or recently created project

 Bus Factor1

Top contributor holds 98% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~45 days

Recently: every ~54 days

Total

41

Last Release

179d ago

Major Versions

v0.21 → v1.0.12023-12-01

v1.1.2 → v2.0.02024-05-20

v2.5.0 → v3.0.02025-07-07

v3.0.1 → v4.0.02026-02-08

PHP version history (3 changes)0.8PHP &gt;=7.4

v0.17PHP &gt;=8.0

v2.2.0PHP &gt;=8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/934b53b68624e78343e3f3367897cbaf5fb01475511a1650d2c99c972c810ec6?d=identicon)[insign](/maintainers/insign)

---

Top Contributors

[![insign](https://avatars.githubusercontent.com/u/1113045?v=4)](https://github.com/insign "insign (1236 commits)")[![easychen](https://avatars.githubusercontent.com/u/1294760?v=4)](https://github.com/easychen "easychen (20 commits)")[![google-labs-jules[bot]](https://avatars.githubusercontent.com/in/842251?v=4)](https://github.com/google-labs-jules[bot] "google-labs-jules[bot] (3 commits)")[![charleypeng](https://avatars.githubusercontent.com/u/2144710?v=4)](https://github.com/charleypeng "charleypeng (2 commits)")

---

Tags

aianthropicclaude-codecodexcrushdartdesktopfluttergeminigemini-clikilo-codemobileopenaiopencode

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/cloudatlas-flyclone/health.svg)

```
[![Health](https://phpackages.com/badges/cloudatlas-flyclone/health.svg)](https://phpackages.com/packages/cloudatlas-flyclone)
```

###  Alternatives

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.7k39.6k](/packages/matomo-matomo)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k19](/packages/tempest-framework)[illuminate/console

The Illuminate Console package.

13046.6M7.1k](/packages/illuminate-console)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

762297.9k49](/packages/civicrm-civicrm-core)[drupal/drupal-driver

A collection of reusable Drupal drivers

6916.6M24](/packages/drupal-drupal-driver)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M650](/packages/shopware-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
