runbuoy 0.1.0__tar.gz

runbuoy-0.1.0/.gitignore

@@ -0,0 +1,24 @@
+.DS_Store
+.env
+.env.*
+!.env.example
+.local-packages/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+*.sqlite
+*.sqlite3
+*.log
+.coverage
+htmlcov/
+build/
+dist/
+DerivedData/
+*.xcuserstate
+xcuserdata/
+server/.apns-mock/
+cli/.runbuoy-test/

runbuoy-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seth Webster
+
+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.

runbuoy-0.1.0/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: runbuoy
+Version: 0.1.0
+Summary: Read-only command status delivery for RunBuoy
+Project-URL: Homepage, https://github.com/TANG617/RunBuoy
+Project-URL: Documentation, https://github.com/TANG617/RunBuoy#readme
+Project-URL: Repository, https://github.com/TANG617/RunBuoy
+Project-URL: Issues, https://github.com/TANG617/RunBuoy/issues
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,monitoring,notifications,progress,runbuoy
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.12
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: keyring<26,>=25
+Requires-Dist: pydantic<3,>=2.8
+Requires-Dist: qrcode<9,>=7.4
+Requires-Dist: rich<15,>=13.7
+Requires-Dist: typer<1,>=0.12
+Description-Content-Type: text/markdown
+
+# RunBuoy CLI
+
+RunBuoy keeps long-running commands visible from an iPhone without exposing a
+remote-control surface. The CLI runs commands locally, records structured
+status and progress, and sends a deliberately limited projection to a paired
+RunBuoy server.
+
+## Requirements
+
+- macOS or Linux
+- Python 3.12 or newer
+- `tmux` for durable runs
+
+Install `tmux` before RunBuoy:
+
+```bash
+# macOS
+brew install tmux
+
+# Debian or Ubuntu
+sudo apt install tmux
+```
+
+## Install
+
+Install the CLI in an isolated environment with
+[uv](https://docs.astral.sh/uv/):
+
+```bash
+uv tool install runbuoy
+```
+
+Or use [pipx](https://pipx.pypa.io/):
+
+```bash
+pipx install runbuoy
+```
+
+The installed executable is available directly:
+
+```bash
+runbuoy doctor
+runbuoy capabilities --json
+```
+
+Upgrade with the same tool used for installation:
+
+```bash
+uv tool upgrade runbuoy
+# or
+pipx upgrade runbuoy
+```
+
+## Quick start
+
+Pair this machine with the RunBuoy iOS app:
+
+```bash
+runbuoy pair
+```
+
+Run a command:
+
+```bash
+runbuoy run -- python3 experiment.py
+```
+
+Send a notification without starting a managed run:
+
+```bash
+runbuoy notify \
+  --title "Build completed" \
+  --body "Release build succeeded" \
+  --level success
+```
+
+RunBuoy does not upload full command arguments, working directories,
+environment variables, source code, or complete logs by default. See the
+[security documentation](https://github.com/TANG617/RunBuoy/blob/main/docs/security.md)
+for the complete data boundary.
+
+## Source and support
+
+Source code, documentation, and issue tracking are available in the
+[RunBuoy repository](https://github.com/TANG617/RunBuoy).
+
+RunBuoy is licensed under the MIT License.

runbuoy-0.1.0/README.md

@@ -0,0 +1,87 @@
+# RunBuoy CLI
+
+RunBuoy keeps long-running commands visible from an iPhone without exposing a
+remote-control surface. The CLI runs commands locally, records structured
+status and progress, and sends a deliberately limited projection to a paired
+RunBuoy server.
+
+## Requirements
+
+- macOS or Linux
+- Python 3.12 or newer
+- `tmux` for durable runs
+
+Install `tmux` before RunBuoy:
+
+```bash
+# macOS
+brew install tmux
+
+# Debian or Ubuntu
+sudo apt install tmux
+```
+
+## Install
+
+Install the CLI in an isolated environment with
+[uv](https://docs.astral.sh/uv/):
+
+```bash
+uv tool install runbuoy
+```
+
+Or use [pipx](https://pipx.pypa.io/):
+
+```bash
+pipx install runbuoy
+```
+
+The installed executable is available directly:
+
+```bash
+runbuoy doctor
+runbuoy capabilities --json
+```
+
+Upgrade with the same tool used for installation:
+
+```bash
+uv tool upgrade runbuoy
+# or
+pipx upgrade runbuoy
+```
+
+## Quick start
+
+Pair this machine with the RunBuoy iOS app:
+
+```bash
+runbuoy pair
+```
+
+Run a command:
+
+```bash
+runbuoy run -- python3 experiment.py
+```
+
+Send a notification without starting a managed run:
+
+```bash
+runbuoy notify \
+  --title "Build completed" \
+  --body "Release build succeeded" \
+  --level success
+```
+
+RunBuoy does not upload full command arguments, working directories,
+environment variables, source code, or complete logs by default. See the
+[security documentation](https://github.com/TANG617/RunBuoy/blob/main/docs/security.md)
+for the complete data boundary.
+
+## Source and support
+
+Source code, documentation, and issue tracking are available in the
+[RunBuoy repository](https://github.com/TANG617/RunBuoy).
+
+RunBuoy is licensed under the MIT License.

runbuoy-0.1.0/pyproject.toml

@@ -0,0 +1,76 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "runbuoy"
+dynamic = ["version"]
+description = "Read-only command status delivery for RunBuoy"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+keywords = ["cli", "monitoring", "notifications", "progress", "runbuoy"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Operating System :: MacOS",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: System :: Monitoring",
+]
+dependencies = [
+  "httpx>=0.27,<1",
+  "keyring>=25,<26",
+  "pydantic>=2.8,<3",
+  "qrcode>=7.4,<9",
+  "rich>=13.7,<15",
+  "typer>=0.12,<1",
+]
+
+[project.scripts]
+runbuoy = "runbuoy.cli.app:main"
+
+[project.urls]
+Homepage = "https://github.com/TANG617/RunBuoy"
+Documentation = "https://github.com/TANG617/RunBuoy#readme"
+Repository = "https://github.com/TANG617/RunBuoy"
+Issues = "https://github.com/TANG617/RunBuoy/issues"
+
+[dependency-groups]
+dev = [
+  "mypy>=1.11,<2",
+  "pytest>=8.3,<9",
+  "pytest-timeout>=2.3,<3",
+  "ruff>=0.6,<1",
+  "types-qrcode>=7.4",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/runbuoy"]
+
+[tool.hatch.version]
+path = "src/runbuoy/__init__.py"
+
+[tool.pytest.ini_options]
+addopts = "-ra"
+testpaths = ["tests"]
+markers = [
+  "tmux: requires the tmux executable and a working local tmux server",
+  "integration: starts local processes",
+]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "RUF"]
+
+[tool.ruff.lint.per-file-ignores]
+"src/runbuoy/cli/app.py" = ["B008"]
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+packages = ["runbuoy"]

runbuoy-0.1.0/src/runbuoy/__init__.py

@@ -0,0 +1,6 @@
+"""RunBuoy CLI and small structured-progress client."""
+
+from runbuoy.sdk import attention, message, phase, progress
+
+__all__ = ["attention", "message", "phase", "progress"]
+__version__ = "0.1.0"

runbuoy-0.1.0/src/runbuoy/__main__.py

@@ -0,0 +1,4 @@
+from runbuoy.cli.app import main
+
+if __name__ == "__main__":
+    main()

runbuoy-0.1.0/src/runbuoy/cli/__init__.py

@@ -0,0 +1 @@
+"""Typer command surface."""