opentine-tui 0.1.0__tar.gz

opentine_tui-0.1.0/.claude/settings.local.json

@@ -0,0 +1,16 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh pr *)",
+      "Bash(pip index *)",
+      "Bash(curl -s https://pypi.org/pypi/opentine/json)",
+      "Bash(python -c \"import sys,json; d=json.load\\(sys.stdin\\); print\\('PyPI latest:', d['info']['version']\\)\")",
+      "Bash(git checkout *)",
+      "Bash(git check-ignore *)",
+      "Bash(git add *)",
+      "Bash(git commit *)",
+      "Bash(git push *)",
+      "Bash(gh run *)"
+    ]
+  }
+}

opentine_tui-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,66 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  # opentine 0.1.1 (with the harness integration the TUI relies on) is not yet on
+  # PyPI; install it from source until the release lands. Drop this and rely on the
+  # pinned PyPI dependency once opentine>=0.1.1 is published.
+  OPENTINE_GIT: "opentine @ git+https://github.com/0xcircuitbreaker/opentine.git@main"
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13"]
+      fail-fast: false
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Upgrade build tooling
+        run: python -m pip install --upgrade pip
+
+      - name: Install opentine from source
+        run: python -m pip install "${{ env.OPENTINE_GIT }}"
+
+      - name: Install opentine-tui with dev extras
+        run: python -m pip install -e ".[dev]"
+
+      - name: Lint with ruff
+        run: ruff check .
+
+      - name: Format check with ruff
+        run: ruff format --check .
+
+      - name: Run tests
+        run: pytest tests -v
+
+      - name: Build package
+        run: python -m build --sdist --wheel --outdir dist
+
+      - name: Check package metadata
+        run: twine check dist/*
+
+      - name: Upload build artifacts
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
+        uses: actions/upload-artifact@v4
+        with:
+          name: opentine-tui-dist
+          path: dist/opentine_tui-*
+          if-no-files-found: error

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

@@ -0,0 +1,69 @@
+name: GitHub Release Artifacts
+
+on:
+  push:
+    tags:
+      - "v*"
+
+env:
+  OPENTINE_GIT: "opentine @ git+https://github.com/0xcircuitbreaker/opentine.git@main"
+
+jobs:
+  release-artifacts:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+      attestations: write
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Upgrade build tooling
+        run: python -m pip install --upgrade pip
+
+      - name: Install opentine from source
+        run: python -m pip install "${{ env.OPENTINE_GIT }}"
+
+      - name: Install opentine-tui with dev extras
+        run: python -m pip install -e ".[dev]"
+
+      - name: Run fast gates
+        run: |
+          ruff check .
+          ruff format --check .
+          pytest tests -q
+
+      - name: Build package
+        run: python -m build --sdist --wheel --outdir dist
+
+      - name: Check package metadata
+        run: twine check dist/*
+
+      - name: Generate SHA256SUMS
+        run: |
+          cd dist
+          sha256sum opentine_tui-* > SHA256SUMS
+
+      - name: Attest build provenance
+        uses: actions/attest-build-provenance@v4
+        with:
+          subject-path: dist/opentine_tui-*
+
+      - name: Upload workflow artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: opentine-tui-release-artifacts
+          path: |
+            dist/opentine_tui-*
+            dist/SHA256SUMS
+
+      - name: Attach artifacts to GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release create "$GITHUB_REF_NAME" dist/opentine_tui-* dist/SHA256SUMS --verify-tag --generate-notes

opentine_tui-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.ruff_cache/
+.pytest_cache/

opentine_tui-0.1.0/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to opentine-tui are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-06-25
+
+First public release.
+
+### Added
+- Three-panel Textual dashboard (runs / steps / details) for `.tine` run artifacts.
+- Run list that keeps corrupt `.tine` files visible with their load or integrity error.
+- Step DAG view with per-step cost and duration, and a detail panel for run and step
+  metadata, inputs, outputs, and errors.
+- Integrity verification (`v`) backed by `opentine`'s SHA-256 manifest digest.
+- Write actions with confirmation modals: fork (`f`), cache replay (`c`),
+  diff (`d`), and scoped resume (`x`).
+- External harness launches: run (`h`), fork + harness (`Ctrl+F`), and
+  replay + harness (`Ctrl+R`), covering the codex, claude-code, cursor, opencode,
+  openclaw, kimi-code, hermes, pi, and generic adapters.
+- `--runs-dir` flag and `OPENTINE_RUNS_DIR` environment variable for selecting the
+  artifact directory.
+- GitHub Actions CI (lint, format, tests, build, metadata check) across
+  Linux/macOS/Windows on Python 3.11–3.13, and a tag-driven release-artifacts
+  workflow.
+
+### Requirements
+- Requires `opentine>=0.1.1`, the first opentine release that ships the
+  `opentine.harnesses` integration layer the dashboard depends on.
+
+[0.1.0]: https://github.com/0xcircuitbreaker/opentine-tui/releases/tag/v0.1.0

opentine_tui-0.1.0/LICENSE

@@ -0,0 +1,119 @@
+Apache License
+Version 2.0, January 2004
+https://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright
+owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities
+that control, are controlled by, or are under common control with that entity.
+For the purposes of this definition, "control" means (i) the power, direct or
+indirect, to cause the direction or management of such entity, whether by
+contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including
+but not limited to software source code, documentation source, and configuration
+files.
+
+"Object" form shall mean any form resulting from mechanical transformation or
+translation of a Source form, including but not limited to compiled object code,
+generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form,
+made available under the License, as indicated by a copyright notice that is
+included in or attached to the work.
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that
+is based on (or derived from) the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship. For the purposes of this License, Derivative Works
+shall not include works that remain separable from, or merely link (or bind by
+name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version
+of the Work and any modifications or additions to that Work or Derivative Works
+thereof, that is intentionally submitted to Licensor for inclusion in the Work
+by the copyright owner or by an individual or Legal Entity authorized to submit
+on behalf of the copyright owner. For the purposes of this definition,
+"submitted" means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems, and
+issue tracking systems that are managed by, or on behalf of, the Licensor for
+the purpose of discussing and improving the Work, but excluding communication
+that is conspicuously marked or otherwise designated in writing by the copyright
+owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
+of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable copyright license to
+reproduce, prepare Derivative Works of, publicly display, publicly perform,
+sublicense, and distribute the Work and such Derivative Works in Source or
+Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License,
+each Contributor hereby grants to You a perpetual, worldwide, non-exclusive,
+no-charge, royalty-free, irrevocable patent license to make, have made, use,
+offer to sell, sell, import, and otherwise transfer the Work.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or
+Derivative Works thereof in any medium, with or without modifications, and in
+Source or Object form, provided that You meet the following conditions:
+
+You must give any other recipients of the Work or Derivative Works a copy of
+this License; and
+
+You must cause any modified files to carry prominent notices stating that You
+changed the files; and
+
+You must retain, in the Source form of any Derivative Works that You distribute,
+all copyright, patent, trademark, and attribution notices from the Source form
+of the Work, excluding those notices that do not pertain to any part of the
+Derivative Works; and
+
+If the Work includes a "NOTICE" text file as part of its distribution, then any
+Derivative Works that You distribute must include a readable copy of the
+attribution notices contained within such NOTICE file.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any
+Contribution intentionally submitted for inclusion in the Work by You to the
+Licensor shall be under the terms and conditions of this License, without any
+additional terms or conditions.
+
+6. Trademarks. This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor, except as required
+for reasonable and customary use in describing the origin of the Work and
+reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in
+writing, Licensor provides the Work on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied, including, without
+limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT,
+MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in
+tort (including negligence), contract, or otherwise, unless required by
+applicable law or agreed to in writing, shall any Contributor be liable to You
+for damages, including any direct, indirect, special, incidental, or
+consequential damages arising as a result of this License or out of the use or
+inability to use the Work.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or
+Derivative Works thereof, You may choose to offer, and charge a fee for,
+acceptance of support, warranty, indemnity, or other liability obligations.
+However, in accepting such obligations, You may act only on Your own behalf and
+on Your sole responsibility, not on behalf of any other Contributor.

opentine_tui-0.1.0/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: opentine-tui
+Version: 0.1.0
+Summary: Terminal dashboard for opentine — visual management console with Textual
+Project-URL: Homepage, https://opentine.com
+Project-URL: Repository, https://github.com/0xcircuitbreaker/opentine-tui
+Project-URL: Issues, https://github.com/0xcircuitbreaker/opentine-tui/issues
+Author: opentine contributors
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: agents,fork,llm,replay,run-tree,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Console :: Curses
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.11
+Requires-Dist: opentine<0.2,>=0.1.1
+Requires-Dist: textual>=3.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.0; extra == 'dev'
+Requires-Dist: pytest>=9.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# opentine-tui
+
+Terminal management console for [opentine](https://github.com/0xcircuitbreaker/opentine)
+agent runs.
+
+Built with [Textual](https://textual.textualize.io/).
+
+## Install
+
+```bash
+pip install opentine-tui
+```
+
+Requires [`opentine`](https://github.com/0xcircuitbreaker/opentine) `>=0.1.1`, the
+first release that ships the harness integration layer the dashboard uses. Until
+`opentine` 0.1.1 is published to PyPI, install it from source first:
+
+```bash
+pip install "opentine @ git+https://github.com/0xcircuitbreaker/opentine.git@main"
+pip install opentine-tui
+```
+
+## Usage
+
+```bash
+tine-dashboard
+opentine-tui
+```
+
+By default the TUI reads `.tine` artifacts from `.tine_runs`. Override that with:
+
+```bash
+tine-dashboard --runs-dir path/to/.tine_runs
+OPENTINE_RUNS_DIR=path/to/.tine_runs tine-dashboard
+```
+
+## Layout
+
+```
+┌── Runs ───────┐ ┌── Steps ───────────────┐ ┌── Details ─────────┐
+│ a3f8 done     │ │ * think "I'll search"  │ │ Run: a3f8          │
+│ b7c1 fail     │ │ > tool search(q="...") │ │ Model: claude      │
+│ c9d2 corrupt  │ │ * think "The mass..."  │ │ Steps: 4           │
+│               │ │ + done                 │ │ Cost: $0.003       │
+│               │ │                        │ │ Duration: 12.3s    │
+└──────────────────┘ └──────────────────────────────┘ └─────────────────────┘
+```
+
+Corrupt `.tine` files remain visible in the run list with their load or integrity
+error in the details panel.
+
+## Keybindings
+
+| Key | Action |
+|---|---|
+| `q` | Quit |
+| `r` | Refresh run list |
+| `1` | Focus runs panel |
+| `2` | Focus steps panel |
+| `3` | Focus details panel |
+| `Enter` | View selected run |
+| `v` | Verify selected `.tine` integrity |
+| `f` | Fork selected run from the selected step |
+| `c` | Write a cached replay from the selected step |
+| `d` | Diff selected run against another run |
+| `x` | Resume selected run when `manifest.resume` is true |
+| `h` | Launch a new external harness run |
+| `Ctrl+F` | Fork selected step and launch a harness |
+| `Ctrl+R` | Replay from selected step with a harness |
+
+Write operations and external harness launches require an explicit confirmation
+modal before they run.
+
+## Development
+
+```bash
+# install opentine (from source until 0.1.1 is on PyPI) and the TUI with dev extras
+pip install "opentine @ git+https://github.com/0xcircuitbreaker/opentine.git@main"
+pip install -e ".[dev]"
+
+ruff check .
+ruff format --check .
+pytest
+```
+
+CI runs lint, format, the test suite, a packaging build, and a `twine` metadata
+check across Linux/macOS/Windows on Python 3.11–3.13. Pushing a `v*` tag builds
+signed release artifacts and attaches them to a GitHub release.
+
+## License
+
+Apache 2.0

opentine_tui-0.1.0/README.md

@@ -0,0 +1,92 @@
+# opentine-tui
+
+Terminal management console for [opentine](https://github.com/0xcircuitbreaker/opentine)
+agent runs.
+
+Built with [Textual](https://textual.textualize.io/).
+
+## Install
+
+```bash
+pip install opentine-tui
+```
+
+Requires [`opentine`](https://github.com/0xcircuitbreaker/opentine) `>=0.1.1`, the
+first release that ships the harness integration layer the dashboard uses. Until
+`opentine` 0.1.1 is published to PyPI, install it from source first:
+
+```bash
+pip install "opentine @ git+https://github.com/0xcircuitbreaker/opentine.git@main"
+pip install opentine-tui
+```
+
+## Usage
+
+```bash
+tine-dashboard
+opentine-tui
+```
+
+By default the TUI reads `.tine` artifacts from `.tine_runs`. Override that with:
+
+```bash
+tine-dashboard --runs-dir path/to/.tine_runs
+OPENTINE_RUNS_DIR=path/to/.tine_runs tine-dashboard
+```
+
+## Layout
+
+```
+┌── Runs ───────┐ ┌── Steps ───────────────┐ ┌── Details ─────────┐
+│ a3f8 done     │ │ * think "I'll search"  │ │ Run: a3f8          │
+│ b7c1 fail     │ │ > tool search(q="...") │ │ Model: claude      │
+│ c9d2 corrupt  │ │ * think "The mass..."  │ │ Steps: 4           │
+│               │ │ + done                 │ │ Cost: $0.003       │
+│               │ │                        │ │ Duration: 12.3s    │
+└──────────────────┘ └──────────────────────────────┘ └─────────────────────┘
+```
+
+Corrupt `.tine` files remain visible in the run list with their load or integrity
+error in the details panel.
+
+## Keybindings
+
+| Key | Action |
+|---|---|
+| `q` | Quit |
+| `r` | Refresh run list |
+| `1` | Focus runs panel |
+| `2` | Focus steps panel |
+| `3` | Focus details panel |
+| `Enter` | View selected run |
+| `v` | Verify selected `.tine` integrity |
+| `f` | Fork selected run from the selected step |
+| `c` | Write a cached replay from the selected step |
+| `d` | Diff selected run against another run |
+| `x` | Resume selected run when `manifest.resume` is true |
+| `h` | Launch a new external harness run |
+| `Ctrl+F` | Fork selected step and launch a harness |
+| `Ctrl+R` | Replay from selected step with a harness |
+
+Write operations and external harness launches require an explicit confirmation
+modal before they run.
+
+## Development
+
+```bash
+# install opentine (from source until 0.1.1 is on PyPI) and the TUI with dev extras
+pip install "opentine @ git+https://github.com/0xcircuitbreaker/opentine.git@main"
+pip install -e ".[dev]"
+
+ruff check .
+ruff format --check .
+pytest
+```
+
+CI runs lint, format, the test suite, a packaging build, and a `twine` metadata
+check across Linux/macOS/Windows on Python 3.11–3.13. Pushing a `v*` tag builds
+signed release artifacts and attaches them to a GitHub release.
+
+## License
+
+Apache 2.0

opentine_tui-0.1.0/opentine_tui/__init__.py

@@ -0,0 +1,32 @@
+"""opentine-tui — Terminal dashboard for opentine agent runs."""
+
+from __future__ import annotations
+
+import argparse
+from collections.abc import Sequence
+
+from opentine_tui.app import OpentineTUI
+
+BRAND = "#FF6900"
+
+
+def build_parser(prog: str | None = None) -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog=prog,
+        description="Terminal management console for opentine .tine runs",
+    )
+    parser.add_argument(
+        "--runs-dir",
+        help="Directory containing .tine artifacts (default: OPENTINE_RUNS_DIR or .tine_runs)",
+    )
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> None:
+    args = build_parser().parse_args(argv)
+    app = OpentineTUI(runs_dir=args.runs_dir)
+    app.run()
+
+
+if __name__ == "__main__":
+    main()