codeaway 0.1.0__tar.gz

codeaway-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,82 @@
+name: publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build and validate distributions
+    runs-on: windows-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - name: Install uv and Python
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          python-version: "3.11"
+
+      - name: Install test environment
+        run: uv sync --extra test
+
+      - name: Run Python tests
+        run: uv run pytest -q
+
+      - name: Run browser tests
+        run: node --test tests/test_web_ui.cjs tests/test_web_dom.cjs tests/test_web_theme.cjs
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Check distribution metadata
+        run: uv run --isolated --no-project --with twine twine check dist/*
+
+      - name: Smoke-test wheel and source distribution
+        shell: pwsh
+        run: |
+          $wheels = @(Get-ChildItem -Path dist -Filter *.whl -File)
+          $sdists = @(Get-ChildItem -Path dist -Filter *.tar.gz -File)
+          if ($wheels.Count -ne 1) {
+            throw "Expected exactly one wheel in dist/, found $($wheels.Count)."
+          }
+          if ($sdists.Count -ne 1) {
+            throw "Expected exactly one source distribution in dist/, found $($sdists.Count)."
+          }
+          uv run --isolated --no-project --with $wheels[0].FullName codeaway --help
+          uv run --isolated --no-project --with $sdists[0].FullName codeaway --help
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: pypi
+      url: https://pypi.org/p/codeaway
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: distributions
+          path: dist/
+
+      - name: Publish distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
+        with:
+          packages-dir: dist/

codeaway-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,43 @@
+name: test
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Windows / Python 3.11
+    runs-on: windows-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - name: Install uv and Python
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          python-version: "3.11"
+
+      - name: Install test environment
+        run: uv sync --extra test
+
+      - name: Run Python tests
+        run: uv run pytest -q
+
+      - name: Run browser tests
+        run: node --test tests/test_web_ui.cjs tests/test_web_dom.cjs tests/test_web_theme.cjs
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Install wheel in a clean environment and run the command
+        shell: pwsh
+        run: |
+          $wheels = @(Get-ChildItem -Path dist -Filter *.whl -File)
+          if ($wheels.Count -ne 1) {
+            throw "Expected exactly one wheel in dist/, found $($wheels.Count)."
+          }
+          uv run --isolated --no-project --with $wheels[0].FullName codeaway --help

codeaway-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+.venv/
+__pycache__/
+*.py[cod]
+/dist/
+/output/
+/uv.lock

codeaway-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CodeAway contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codeaway-0.1.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.5
+Name: codeaway
+Version: 0.1.0
+Summary: Control a local coding agent from your phone
+Project-URL: Homepage, https://github.com/jmoraispk/codeaway2
+Project-URL: Repository, https://github.com/jmoraispk/codeaway2
+Project-URL: Issues, https://github.com/jmoraispk/codeaway2/issues
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,coding agents,remote control,tailscale
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development
+Requires-Python: >=3.11
+Requires-Dist: pillow>=11.0
+Requires-Dist: uiautomation>=2.0.20; sys_platform == 'win32'
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# CodeAway
+
+![CodeAway sends commands to desktop coding agents and returns replies and live status](https://raw.githubusercontent.com/jmoraispk/codeaway2/main/docs/assets/codeaway-hero.png)
+
+CodeAway is a thin, browser-based remote control for local AI coding agents.
+Version 0.1 supports one pairing only: **Windows with Codex Desktop**. The
+source repository is `codeaway2`; the Python package and command are
+`codeaway`.
+
+> Status: early alpha. The Windows/Codex Desktop phone flow has been
+> smoke-tested; expect rough edges and breaking changes.
+
+## Install
+
+The shortest recommended path is:
+
+```powershell
+uvx codeaway
+```
+
+`uvx` is convenient, not required. You can instead install with either:
+
+```powershell
+pipx install codeaway
+```
+
+```powershell
+py -m pip install codeaway
+```
+
+## Platform support
+
+Windows with Codex Desktop is the supported pairing. macOS and Linux can
+install the package, but desktop control for those platforms is not implemented
+yet.
+
+## Run CodeAway
+
+The first run is laptop-only. Start CodeAway in the foreground:
+
+```powershell
+uvx codeaway
+```
+
+It listens on `127.0.0.1:8765` and opens `/setup` in the laptop browser. Choose
+the visible Codex Desktop window and draw all three capture regions:
+
+- **Sidebar:** the projects and tasks on the left.
+- **Conversation:** the right pane above the input.
+- **Composer:** the chat box only; it may grow taller. Do not include the
+  full-width toolbar or status row.
+
+To enable phone access, restart with an address assigned to the laptop on your
+LAN or Tailscale network:
+
+```powershell
+uvx codeaway --ip <IPv4-LAN-or-Tailscale-address>
+```
+
+The explicit address is saved only after it binds successfully. Later
+`uvx codeaway` launches reuse both that address and the saved calibration. If
+the saved Codex window and all three regions resolve, CodeAway prints the phone
+workspace URL without opening a laptop browser. The phone workspace still
+links to `/setup` when recalibration is needed.
+
+If a cached address is no longer available, CodeAway warns, falls back to
+`127.0.0.1`, and saves that fallback. An invalid explicit address exits instead
+of silently changing interfaces. Use `--no-browser` to suppress an otherwise
+necessary setup launch and `--port PORT` to select and cache another port.
+CodeAway v0.1 accepts IPv4 literals only; IPv6 addresses are rejected with an
+actionable startup error.
+
+> **Security:** A non-loopback endpoint grants full desktop mouse and keyboard
+> input control to every device that can reach it. CodeAway v0.1 has no pairing
+> or authentication, so expose it only on a network boundary you trust.
+
+## Architecture
+
+CodeAway deliberately separates two independent backend axes:
+
+| Module | Backends | Responsibility |
+| --- | --- | --- |
+| `agents.py` | Codex first; Claude Code and Cursor later | Owns application semantics: detection, projects and tasks, navigation, calibrated surfaces, and actions |
+| `desktop.py` | Windows first; macOS and Linux later | Owns OS mechanics: windows, screenshots, accessibility, mouse, keyboard, and clipboard operations |
+
+The server composes one agent backend with one desktop backend. For the first
+release that pair is Codex Desktop on Windows. Agent backends do not contain
+Windows APIs, and desktop backends do not contain Codex-specific behavior.

codeaway-0.1.0/README.md

@@ -0,0 +1,88 @@
+# CodeAway
+
+![CodeAway sends commands to desktop coding agents and returns replies and live status](https://raw.githubusercontent.com/jmoraispk/codeaway2/main/docs/assets/codeaway-hero.png)
+
+CodeAway is a thin, browser-based remote control for local AI coding agents.
+Version 0.1 supports one pairing only: **Windows with Codex Desktop**. The
+source repository is `codeaway2`; the Python package and command are
+`codeaway`.
+
+> Status: early alpha. The Windows/Codex Desktop phone flow has been
+> smoke-tested; expect rough edges and breaking changes.
+
+## Install
+
+The shortest recommended path is:
+
+```powershell
+uvx codeaway
+```
+
+`uvx` is convenient, not required. You can instead install with either:
+
+```powershell
+pipx install codeaway
+```
+
+```powershell
+py -m pip install codeaway
+```
+
+## Platform support
+
+Windows with Codex Desktop is the supported pairing. macOS and Linux can
+install the package, but desktop control for those platforms is not implemented
+yet.
+
+## Run CodeAway
+
+The first run is laptop-only. Start CodeAway in the foreground:
+
+```powershell
+uvx codeaway
+```
+
+It listens on `127.0.0.1:8765` and opens `/setup` in the laptop browser. Choose
+the visible Codex Desktop window and draw all three capture regions:
+
+- **Sidebar:** the projects and tasks on the left.
+- **Conversation:** the right pane above the input.
+- **Composer:** the chat box only; it may grow taller. Do not include the
+  full-width toolbar or status row.
+
+To enable phone access, restart with an address assigned to the laptop on your
+LAN or Tailscale network:
+
+```powershell
+uvx codeaway --ip <IPv4-LAN-or-Tailscale-address>
+```
+
+The explicit address is saved only after it binds successfully. Later
+`uvx codeaway` launches reuse both that address and the saved calibration. If
+the saved Codex window and all three regions resolve, CodeAway prints the phone
+workspace URL without opening a laptop browser. The phone workspace still
+links to `/setup` when recalibration is needed.
+
+If a cached address is no longer available, CodeAway warns, falls back to
+`127.0.0.1`, and saves that fallback. An invalid explicit address exits instead
+of silently changing interfaces. Use `--no-browser` to suppress an otherwise
+necessary setup launch and `--port PORT` to select and cache another port.
+CodeAway v0.1 accepts IPv4 literals only; IPv6 addresses are rejected with an
+actionable startup error.
+
+> **Security:** A non-loopback endpoint grants full desktop mouse and keyboard
+> input control to every device that can reach it. CodeAway v0.1 has no pairing
+> or authentication, so expose it only on a network boundary you trust.
+
+## Architecture
+
+CodeAway deliberately separates two independent backend axes:
+
+| Module | Backends | Responsibility |
+| --- | --- | --- |
+| `agents.py` | Codex first; Claude Code and Cursor later | Owns application semantics: detection, projects and tasks, navigation, calibrated surfaces, and actions |
+| `desktop.py` | Windows first; macOS and Linux later | Owns OS mechanics: windows, screenshots, accessibility, mouse, keyboard, and clipboard operations |
+
+The server composes one agent backend with one desktop backend. For the first
+release that pair is Codex Desktop on Windows. Agent backends do not contain
+Windows APIs, and desktop backends do not contain Codex-specific behavior.

codeaway-0.1.0/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "codeaway"
+version = "0.1.0"
+description = "Control a local coding agent from your phone"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["ai", "coding agents", "remote control", "tailscale"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Topic :: Software Development",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: Microsoft :: Windows",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+]
+dependencies = [
+  "Pillow>=11.0",
+  "uiautomation>=2.0.20; sys_platform == 'win32'",
+]
+
+[project.urls]
+Homepage = "https://github.com/jmoraispk/codeaway2"
+Repository = "https://github.com/jmoraispk/codeaway2"
+Issues = "https://github.com/jmoraispk/codeaway2/issues"
+
+[project.optional-dependencies]
+test = ["pytest>=8.0"]
+
+[project.scripts]
+codeaway = "codeaway.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/codeaway"]
+artifacts = [
+  "src/codeaway/web/*.html",
+  "src/codeaway/web/*.css",
+  "src/codeaway/web/*.js",
+]
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+  "/.superpowers/**",
+  "/output/**",
+  "/dist/**",
+  "/uv.lock",
+  "/.pytest_cache/**",
+  "/.ruff_cache/**",
+  "/.mypy_cache/**",
+  "**/__pycache__/**",
+  "**/*.py[cod]",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

codeaway-0.1.0/src/codeaway/__init__.py

@@ -0,0 +1,4 @@
+from importlib.metadata import version
+
+
+__version__ = version("codeaway")

codeaway-0.1.0/src/codeaway/__main__.py

@@ -0,0 +1,5 @@
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())