agr-opentui 0.2.0__tar.gz → 0.2.2__tar.gz

{agr_opentui-0.2.0 → agr_opentui-0.2.2}/.github/renovate.json5

@@ -10,6 +10,13 @@
   labels: ["dependencies"],
   rangeStrategy: "bump",
   packageRules: [
+    {
+      matchCategories: ["python"],
+      groupName: "all python dependencies",
+      groupSlug: "all-python-dependencies",
+      separateMajorMinor: false,
+      separateMinorPatch: false
+    },
     {
       matchManagers: ["npm"],
       matchUpdateTypes: ["major"],

agr_opentui-0.2.2/.github/workflows/bump-version.yml

@@ -0,0 +1,140 @@
+name: bump-version
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "New version (example: 0.3.0)"
+        required: true
+        type: string
+      branch:
+        description: "Branch to update"
+        required: true
+        default: "master"
+        type: string
+      create_tag:
+        description: "Create and push git tag v<version> after bump"
+        required: true
+        default: true
+        type: boolean
+      create_release:
+        description: "Create a GitHub release after tagging"
+        required: false
+        default: true
+        type: boolean
+  workflow_call:
+    inputs:
+      version:
+        description: "New version (example: 0.3.0)"
+        required: true
+        type: string
+      branch:
+        description: "Branch to update"
+        required: true
+        type: string
+      create_tag:
+        description: "Create and push git tag v<version> after bump"
+        required: true
+        type: boolean
+      create_release:
+        description: "Create a GitHub release after tagging"
+        required: false
+        default: true
+        type: boolean
+
+permissions:
+  contents: write
+
+jobs:
+  bump:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout target branch
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          ref: ${{ inputs.branch }}
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.14.3"
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Validate and apply version bump
+        env:
+          NEW_VERSION: ${{ inputs.version }}
+        run: |
+          python - <<'PY'
+          import os
+          import pathlib
+          import re
+
+          new_version = os.environ["NEW_VERSION"].strip()
+          if not re.fullmatch(r"[0-9]+\.[0-9]+\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?", new_version):
+            raise SystemExit(
+              f"Invalid version '{new_version}'. Expected SemVer-like format, e.g. 0.3.0 or 0.3.0-rc.1"
+            )
+
+          pyproject_path = pathlib.Path("pyproject.toml")
+          content = pyproject_path.read_text(encoding="utf-8")
+          updated, count = re.subn(
+            r'(?m)^version = ".*"$',
+            f'version = "{new_version}"',
+            content,
+            count=1,
+          )
+          if count != 1:
+            raise SystemExit("Could not update [project].version in pyproject.toml")
+          pyproject_path.write_text(updated, encoding="utf-8")
+          PY
+
+      - name: Regenerate uv.lock
+        run: uv lock
+
+      - name: Commit and push
+        env:
+          NEW_VERSION: ${{ inputs.version }}
+          TARGET_BRANCH: ${{ inputs.branch }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+          if git diff --quiet -- pyproject.toml uv.lock; then
+            echo "No changes to commit."
+            exit 0
+          fi
+
+          git add pyproject.toml uv.lock
+          git commit -m "chore: bump version to ${NEW_VERSION}"
+          git push origin "HEAD:${TARGET_BRANCH}"
+
+      - name: Create and push version tag
+        if: inputs.create_tag
+        env:
+          NEW_VERSION: ${{ inputs.version }}
+        run: |
+          TAG="v${NEW_VERSION}"
+          if git rev-parse -q --verify "refs/tags/${TAG}" >/dev/null; then
+            echo "Tag ${TAG} already exists locally."
+            exit 1
+          fi
+
+          if git ls-remote --exit-code --tags origin "refs/tags/${TAG}" >/dev/null; then
+            echo "Tag ${TAG} already exists on origin."
+            exit 1
+          fi
+
+          git tag -a "${TAG}" -m "Release ${TAG}"
+          git push origin "${TAG}"
+
+      - name: Create GitHub release
+        if: inputs.create_tag && inputs.create_release
+        uses: softprops/action-gh-release@a06a81a03ee405af7f2048a818ed3f03bbf83c7b # v2.5.0
+        with:
+          tag_name: v${{ inputs.version }}
+          name: v${{ inputs.version }}
+          generate_release_notes: true
+          prerelease: ${{ contains(inputs.version, '-') }}

{agr_opentui-0.2.0 → agr_opentui-0.2.2}/.github/workflows/publish-pypi.yml

@@ -5,6 +5,20 @@ on:
     types: [published]
   workflow_dispatch:
     inputs:
+      bump_version:
+        description: "Run bump-version before building and publishing"
+        required: true
+        type: boolean
+        default: false
+      version:
+        description: "New version to use when bump_version is enabled (example: 0.3.0)"
+        required: false
+        type: string
+      branch:
+        description: "Branch to build from (and bump when enabled)"
+        required: true
+        type: string
+        default: master
       target:
         description: "Where to publish the package"
         required: true
@@ -14,11 +28,34 @@ on:
           - testpypi
         default: pypi
 
+permissions:
+  contents: write
+
 jobs:
+  bump-version:
+    if: github.event_name == 'workflow_dispatch' && inputs.bump_version
+    uses: ./.github/workflows/bump-version.yml
+    with:
+      version: ${{ inputs.version }}
+      branch: ${{ inputs.branch }}
+      create_tag: true
+      create_release: false
+    secrets: inherit
+
   build:
+    needs: bump-version
+    if: ${{ always() && (needs.bump-version.result == 'success' || needs.bump-version.result == 'skipped') }}
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout
+      - name: Checkout (workflow_dispatch branch)
+        if: github.event_name == 'workflow_dispatch'
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          ref: ${{ inputs.branch }}
+          fetch-depth: 0
+
+      - name: Checkout (release ref)
+        if: github.event_name == 'release'
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup Python

agr_opentui-0.2.2/PKG-INFO

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: agr-opentui
+Version: 0.2.2
+Summary: OpenTUI frontend for agr
+Project-URL: Homepage, https://github.com/RelativeSure/agr-opentui
+Project-URL: Repository, https://github.com/RelativeSure/agr-opentui
+Project-URL: Issues, https://github.com/RelativeSure/agr-opentui/issues
+Author: Rasmus
+License-Expression: MIT
+Keywords: agr,cli,opentui,skills,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.14
+Requires-Dist: agr>=0.7.4
+Description-Content-Type: text/markdown
+
+# OpenTUI for agr
+
+OpenTUI front-end for managing `agr` skills: browse `agr.toml`, install/remove skills, preview `SKILL.md`, and run skills via `agrx`. Skill discovery is based on `https://github.com/kasperjunge/agent-resources`.
+
+## Usage
+
+Tabs:
+- `Skills`: shows dependencies from `agr.toml` and install state.
+- `Discover`: shows skills from `skills.json` (optional).
+
+Common keys:
+- `Tab` / `Shift+Tab`: switch tabs
+- Arrow keys: move selection
+- `space`: toggle select
+- `H`: help
+- `q`: quit
+
+Skills tab keys:
+- `a`: add skill (handle or `owner/repo/path`)
+- `i`: install selected (bulk)
+- `r`: remove selected (bulk)
+- `v`: preview `SKILL.md`
+- `g`: run with default options (`agrx`)
+- `G`: open run options (tool, interactive, prompt, extra args)
+- `u`: check discover list updates
+- `U`: apply update (no confirm)
+- `s`: apply update (confirm)
+- `S`: apply update + sync (no confirm)
+- `c`: reload config
+
+Discover tab keys:
+- `i`: add selected
+- `y`: copy handle/repo to clipboard
+- `a`: add skill
+- `c`: reload config
+
+Run options keys (when the modal is open):
+- `t`: cycle tool
+- `u`: toggle `--interactive`
+- `p`: edit `--prompt`
+- `e`: edit extra args
+- `Enter`: run
+- `Esc`: close
+
+## Quick Cheat Sheet
+
+Primary flow:
+- `Tab` to `Skills`
+- Arrow keys to select
+- `g` to run, `G` for run options
+
+Bulk actions:
+- `space` to multi-select
+- `i` install or `r` remove (Skills tab)
+
+Discover flow:
+- `Tab` to `Discover`
+- Arrow keys to select
+- `i` to add, `y` to copy handle
+
+## Requirements
+
+Runtime (using `agr-tui`):
+- Python 3.10+
+- `uv`
+- `agr` + `agrx` on your `PATH`
+
+Build/Development (working on this repo):
+- Bun 1.3.8+
+- Zig (required by OpenTUI build tooling)
+
+## Install
+
+```bash
+bun install
+```
+
+## Run
+
+```bash
+bun run src/main.ts
+```
+
+Run it from the repo you want to manage (the current working directory is the target repo).
+`agr.toml` is expected in that target repo for `agr add/remove/sync` operations.
+
+### Run From Target Repo
+
+```bash
+cd /path/to/your/project
+agr-tui
+```
+
+`agr-opentui` itself does not need to contain your target repo's `agr.toml`.
+
+## Build
+
+```bash
+bun run build
+```
+
+This creates `bin/agr-tui`.
+
+## Publish to PyPI
+
+One-time setup:
+- Create a `pypi` environment in this GitHub repo.
+- In your PyPI project settings, add this repo/workflow as a Trusted Publisher for `.github/workflows/publish-pypi.yml`.
+- Optional: add `testpypi` environment and TestPyPI Trusted Publisher too.
+
+Publish via GitHub Actions:
+- Release publish: creating a GitHub release triggers publish to PyPI.
+- Manual: run `publish-pypi` workflow and choose `pypi` or `testpypi`.
+
+Publish from local machine:
+
+```bash
+python -m pip install --upgrade build twine
+make py-publish        # Upload to PyPI
+make py-publish-test   # Upload to TestPyPI
+```
+
+## Bump Version
+
+Update package version before creating a release:
+
+1. Edit `pyproject.toml` and bump `[project].version`.
+2. Regenerate `uv.lock` so the local package entry matches:
+
+```bash
+uv lock
+```
+
+3. Run checks:
+
+```bash
+make check
+```
+
+4. Commit the version bump:
+
+```bash
+git add pyproject.toml uv.lock
+git commit -m "chore: bump version to X.Y.Z"
+```
+
+5. Create a GitHub release for `vX.Y.Z` (or manually run `publish-pypi` workflow).
+
+`publish-pypi.yml` runs automatically when a release is published.
+
+Alternative: use `.github/workflows/bump-version.yml` via **Actions → bump-version → Run workflow** and provide:
+- `version` (required): target version like `0.3.0`
+- `branch` (required): target branch to update (default `master`)
+- `create_tag` (required, default enabled): creates/pushes tag `v<version>` and creates a GitHub Release
+
+## Discover List (`skills.json`)
+
+If `skills.json` exists, the `Discover` tab will list its entries. It supports:
+
+- An array of strings or objects (`{ "label": "...", "handle": "...", "repo": "owner/repo" }`).
+- An object with `source` metadata and `skills` array (see `skills.json` in this repo).
+
+When a `source` is configured, the app checks the remote list periodically (about every 6 hours) and can update `skills.json` using the `u`/`U`/`s`/`S` controls.
+
+## Troubleshooting
+
+- `Missing agr.toml`: run the app from a repo that has `agr.toml`, or create one.
+- `uv not found`: install `uv` and ensure it’s on `PATH`.
+- `agr/agrx not found`: install `agr` and ensure it’s on `PATH`.
+- `python not found`: install Python 3.
+- `skills.json not found` or parse errors: fix the file format (array or `{ "source": ..., "skills": [...] }`).
+- Discover list not updating: check the `source` URL/repo/branch/path and network access.
+- `SKILL.md` preview says “not found”: the skill may not ship a `SKILL.md` or the path is nonstandard.
+- Copy to clipboard doesn’t work: install `pbcopy` (macOS), `wl-copy` (Wayland), or `xclip` (X11).
+
+## Notes
+
+- All actions run through `uv` (`uv run agr`, `uv run agrx`, and `uv run python -m agr_opentui.bridge`).
+- If `agr.toml` is missing in the current directory, install/remove/sync commands are blocked and a warning is shown.
+- Logs are written to `/tmp/agr-opentui.log`.

{agr_opentui-0.2.0 → agr_opentui-0.2.2}/README.md

@@ -60,12 +60,15 @@ Discover flow:
 
 ## Requirements
 
-- Bun 1.3.8+
-- Zig (required by OpenTUI build tooling)
+Runtime (using `agr-tui`):
 - Python 3.10+
 - `uv`
 - `agr` + `agrx` on your `PATH`
 
+Build/Development (working on this repo):
+- Bun 1.3.8+
+- Zig (required by OpenTUI build tooling)
+
 ## Install
 
 ```bash
@@ -117,6 +120,39 @@ make py-publish        # Upload to PyPI
 make py-publish-test   # Upload to TestPyPI
 ```
 
+## Bump Version
+
+Update package version before creating a release:
+
+1. Edit `pyproject.toml` and bump `[project].version`.
+2. Regenerate `uv.lock` so the local package entry matches:
+
+```bash
+uv lock
+```
+
+3. Run checks:
+
+```bash
+make check
+```
+
+4. Commit the version bump:
+
+```bash
+git add pyproject.toml uv.lock
+git commit -m "chore: bump version to X.Y.Z"
+```
+
+5. Create a GitHub release for `vX.Y.Z` (or manually run `publish-pypi` workflow).
+
+`publish-pypi.yml` runs automatically when a release is published.
+
+Alternative: use `.github/workflows/bump-version.yml` via **Actions → bump-version → Run workflow** and provide:
+- `version` (required): target version like `0.3.0`
+- `branch` (required): target branch to update (default `master`)
+- `create_tag` (required, default enabled): creates/pushes tag `v<version>` and creates a GitHub Release
+
 ## Discover List (`skills.json`)
 
 If `skills.json` exists, the `Discover` tab will list its entries. It supports:

agr_opentui-0.2.2/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "agr-opentui"
+version = "0.2.2"
+description = "OpenTUI frontend for agr"
+readme = "README.md"
+license = "MIT"
+authors = [
+  { name = "Rasmus" },
+]
+keywords = ["agr", "tui", "cli", "skills", "opentui"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Build Tools",
+  "Topic :: Utilities",
+]
+requires-python = ">=3.14"
+dependencies = [
+  "agr>=0.7.4",
+]
+
+[project.urls]
+Homepage = "https://github.com/RelativeSure/agr-opentui"
+Repository = "https://github.com/RelativeSure/agr-opentui"
+Issues = "https://github.com/RelativeSure/agr-opentui/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

{agr_opentui-0.2.0 → agr_opentui-0.2.2}/uv.lock

@@ -1,6 +1,6 @@
 version = 1
 revision = 3
-requires-python = ">=3.10"
+requires-python = ">=3.14"
 
 [[package]]
 name = "agr"
@@ -19,7 +19,7 @@ wheels = [
 
 [[package]]
 name = "agr-opentui"
-version = "0.2.0"
+version = "0.2.2"
 source = { editable = "." }
 dependencies = [
     { name = "agr" },
@@ -33,9 +33,7 @@ name = "anyio"
 version = "4.12.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
     { name = "idna" },
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/96/f0/5eb65b2bb0d09ac6776f2eb54adee6abe8228ea05b20a5ad0e4945de8aac/anyio-4.12.1.tar.gz", hash = "sha256:41cfcc3a4c85d3f05c932da7c26d0201ac36f72abd4435ba90d0464a3ffed703", size = 228685, upload-time = "2026-01-06T11:45:21.246Z" }
 wheels = [
@@ -72,18 +70,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
 ]
 
-[[package]]
-name = "exceptiongroup"
-version = "1.3.1"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/8a/0e/97c33bf5009bdbac74fd2beace167cab3f978feb69cc36f1ef79360d6c4e/exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598", size = 16740, upload-time = "2025-11-21T23:01:53.443Z" },
-]
-
 [[package]]
 name = "h11"
 version = "0.16.0"

agr_opentui-0.2.0/PKG-INFO

@@ -1,6 +0,0 @@
-Metadata-Version: 2.4
-Name: agr-opentui
-Version: 0.2.0
-Summary: OpenTUI frontend for agr
-Requires-Python: >=3.14.3
-Requires-Dist: agr>=0.7.4

agr_opentui-0.2.0/pyproject.toml

@@ -1,12 +0,0 @@
-[project]
-name = "agr-opentui"
-version = "0.2.0"
-description = "OpenTUI frontend for agr"
-requires-python = ">=3.14.3"
-dependencies = [
-  "agr>=0.7.4",
-]
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"