agr-opentui 0.2.1__tar.gz → 0.3.1__tar.gz

agr_opentui-0.3.1/.github/CODEOWNERS

@@ -0,0 +1,5 @@
+# These owners will be the default owners for everything in
+# the repo. Unless a later match takes precedence,
+# @global-owner1 and @global-owner2 will be requested for
+# review when someone opens a pull request.
+*       @RelativeSure

agr_opentui-0.3.1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

agr_opentui-0.3.1/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/.github/workflows/bump-version.yml

@@ -15,7 +15,31 @@ on:
       create_tag:
         description: "Create and push git tag v<version> after bump"
         required: true
-        default: false
+        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:
@@ -37,7 +61,7 @@ jobs:
           python-version: "3.14.3"
 
       - name: Setup uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
 
       - name: Validate and apply version bump
         env:
@@ -107,7 +131,7 @@ jobs:
           git push origin "${TAG}"
 
       - name: Create GitHub release
-        if: inputs.create_tag
+        if: inputs.create_tag && inputs.create_release
         uses: softprops/action-gh-release@a06a81a03ee405af7f2048a818ed3f03bbf83c7b # v2.5.0
         with:
           tag_name: v${{ inputs.version }}

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/.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.1 → agr_opentui-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agr-opentui
-Version: 0.2.1
+Version: 0.3.1
 Summary: OpenTUI frontend for agr
 Project-URL: Homepage, https://github.com/RelativeSure/agr-opentui
 Project-URL: Repository, https://github.com/RelativeSure/agr-opentui
@@ -17,13 +17,25 @@ 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-Python: >=3.14.3
 Requires-Dist: agr>=0.7.4
 Description-Content-Type: text/markdown
 
-# OpenTUI for agr
+<div align="center">
 
-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`.
+# OpenTUI for `agr` and `agrx`
+
+An OpenTUI interface for the `agr`/`agrx` CLI: view configured skills, trigger `agr` actions and preview `SKILL.md`
+
+[![PyPI](https://img.shields.io/pypi/v/agr-opentui?color=blue)](https://pypi.org/project/agr-opentui/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+</div>
+
+---
+
+`agr-opentui` is an OpenTUI front-end for `agr`/`agrx`.
+The default discover source in this repo points to `https://github.com/kasperjunge/agent-resources`.
 
 ## Usage
 
@@ -83,95 +95,50 @@ 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`
 
-## Install
-
-```bash
-bun install
-```
+### Build/Development (working on this repo):
+- Bun 1.3.8+
+- Zig (required by OpenTUI build tooling)
 
-## Run
+#### Build
 
 ```bash
-bun run src/main.ts
+bun run build
 ```
-
-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
-
+or
 ```bash
-cd /path/to/your/project
-agr-tui
+make build
 ```
-
-`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:
+#### Install
 
 ```bash
-python -m pip install --upgrade build twine
-make py-publish        # Upload to PyPI
-make py-publish-test   # Upload to TestPyPI
+bun install
 ```
 
-## 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:
+#### Run
 
 ```bash
-uv lock
+bun run src/main.ts
 ```
 
-3. Run checks:
-
-```bash
-make check
-```
+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.
 
-4. Commit the version bump:
+### Run From Target Repo
 
 ```bash
-git add pyproject.toml uv.lock
-git commit -m "chore: bump version to X.Y.Z"
+cd /path/to/your/project
+agr-tui
 ```
 
-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): when enabled, creates/pushes tag `v<version>` and creates a GitHub Release
+`agr-opentui` itself does not need to contain your target repo's `agr.toml`.
 
 ## Discover List (`skills.json`)
 
@@ -180,6 +147,8 @@ 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).
 
+In this repository, `skills.json` is configured to source skills from `kasperjunge/agent-resources` (`agr.toml` on `main`).
+
 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
@@ -191,7 +160,6 @@ When a `source` is configured, the app checks the remote list periodically (abou
 - `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
 

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/README.md

@@ -1,6 +1,18 @@
-# OpenTUI for agr
+<div align="center">
 
-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`.
+# OpenTUI for `agr` and `agrx`
+
+An OpenTUI interface for the `agr`/`agrx` CLI: view configured skills, trigger `agr` actions and preview `SKILL.md`
+
+[![PyPI](https://img.shields.io/pypi/v/agr-opentui?color=blue)](https://pypi.org/project/agr-opentui/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+</div>
+
+---
+
+`agr-opentui` is an OpenTUI front-end for `agr`/`agrx`.
+The default discover source in this repo points to `https://github.com/kasperjunge/agent-resources`.
 
 ## Usage
 
@@ -60,95 +72,50 @@ 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`
 
-## Install
-
-```bash
-bun install
-```
+### Build/Development (working on this repo):
+- Bun 1.3.8+
+- Zig (required by OpenTUI build tooling)
 
-## Run
+#### Build
 
 ```bash
-bun run src/main.ts
+bun run build
 ```
-
-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
-
+or
 ```bash
-cd /path/to/your/project
-agr-tui
+make build
 ```
-
-`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:
+#### Install
 
 ```bash
-python -m pip install --upgrade build twine
-make py-publish        # Upload to PyPI
-make py-publish-test   # Upload to TestPyPI
+bun install
 ```
 
-## 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:
+#### Run
 
 ```bash
-uv lock
+bun run src/main.ts
 ```
 
-3. Run checks:
-
-```bash
-make check
-```
+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.
 
-4. Commit the version bump:
+### Run From Target Repo
 
 ```bash
-git add pyproject.toml uv.lock
-git commit -m "chore: bump version to X.Y.Z"
+cd /path/to/your/project
+agr-tui
 ```
 
-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): when enabled, creates/pushes tag `v<version>` and creates a GitHub Release
+`agr-opentui` itself does not need to contain your target repo's `agr.toml`.
 
 ## Discover List (`skills.json`)
 
@@ -157,6 +124,8 @@ 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).
 
+In this repository, `skills.json` is configured to source skills from `kasperjunge/agent-resources` (`agr.toml` on `main`).
+
 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
@@ -168,7 +137,6 @@ When a `source` is configured, the app checks the remote list periodically (abou
 - `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
 

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agr-opentui"
-version = "0.2.1"
+version = "0.3.1"
 description = "OpenTUI frontend for agr"
 readme = "README.md"
 license = "MIT"
@@ -19,7 +19,7 @@ classifiers = [
   "Topic :: Software Development :: Build Tools",
   "Topic :: Utilities",
 ]
-requires-python = ">=3.14"
+requires-python = ">=3.14.3"
 dependencies = [
   "agr>=0.7.4",
 ]

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/src/app.ts

@@ -353,6 +353,7 @@ function renderActions(): void {
   renderActionsWithUi({
     tab: getActiveTab() === "Discover" ? "Discover" : "Skills",
     rowCount: actionLines.length,
+    updateAvailable: state.updateAvailable,
     lines: actionLines,
   });
 }

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/src/app_logic.ts

@@ -323,9 +323,12 @@ export function buildHelpLines(tab: "Skills" | "Discover"): string[] {
   ];
 }
 
-export function buildActionLines(tab: "Skills" | "Discover"): string[] {
+export function buildActionLines(
+  tab: "Skills" | "Discover",
+  options?: { updateAvailable?: boolean },
+): string[] {
   if (tab === "Skills") {
-    return [
+    const lines = [
       "f: filter list",
       "p: pin selected",
       "space: toggle select",
@@ -337,9 +340,6 @@ export function buildActionLines(tab: "Skills" | "Discover"): string[] {
       "g: run",
       "G: run options",
       "u: check updates",
-      "U: apply update",
-      "s: apply (confirm)",
-      "S: apply + sync",
       "a: add skill",
       "d: doctor",
       "T: test popup",
@@ -349,16 +349,18 @@ export function buildActionLines(tab: "Skills" | "Discover"): string[] {
       "Arrow keys: move",
       "q: quit",
     ];
+    if (options?.updateAvailable) {
+      lines.splice(11, 0, "U: apply update", "s: apply (confirm)", "S: apply + sync");
+    }
+    return lines;
   }
   return [
     "f: filter list",
     "p: pin selected",
     "i: add selected",
-    "r: remove selected",
     "z: undo last add/remove",
     "L: run history",
     "y: copy handle/repo",
-    "space: toggle select",
     "a: add skill",
     "d: doctor",
     "T: test popup",

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/src/services/render_actions.ts

@@ -4,8 +4,9 @@ import { applyRows } from "../ui/rows_render";
 export function renderActionsWithUi(input: {
   tab: "Skills" | "Discover";
   rowCount: number;
+  updateAvailable: boolean;
   lines: Array<{ content: unknown; fg: unknown }>;
 }): void {
-  const rows = buildActionRows({ tab: input.tab, rowCount: input.rowCount });
+  const rows = buildActionRows({ tab: input.tab, rowCount: input.rowCount, updateAvailable: input.updateAvailable });
   applyRows(input.lines, rows);
 }

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/src/ui/controller.ts

@@ -166,8 +166,12 @@ export function buildDetailsRows(input: {
   return rows;
 }
 
-export function buildActionRows(input: { tab: "Skills" | "Discover"; rowCount: number }): UiRow[] {
-  const lines = buildActionLines(input.tab);
+export function buildActionRows(input: {
+  tab: "Skills" | "Discover";
+  rowCount: number;
+  updateAvailable?: boolean;
+}): UiRow[] {
+  const lines = buildActionLines(input.tab, { updateAvailable: input.updateAvailable });
   const rows: UiRow[] = [];
   for (let i = 0; i < input.rowCount; i += 1) {
     const content = lines[i] ?? "";
@@ -280,7 +284,11 @@ export function buildThreePaneSnapshot(input: {
     rowCount: 12,
   });
 
-  const actions = buildActionRows({ tab: input.tab, rowCount: 12 });
+  const actions = buildActionRows({
+    tab: input.tab,
+    rowCount: 12,
+    updateAvailable: false,
+  });
 
   return {
     list: list.rows.map((row) => row.content),

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/test/app_logic.test.ts

@@ -288,7 +288,7 @@ describe("integration smoke: mocked command run", () => {
 
 describe("help/action line snapshots", () => {
   test("skills action lines stay stable", () => {
-    expect(buildActionLines("Skills")).toEqual([
+    expect(buildActionLines("Skills", { updateAvailable: true })).toEqual([
       "f: filter list",
       "p: pin selected",
       "space: toggle select",
@@ -314,6 +314,30 @@ describe("help/action line snapshots", () => {
     ]);
   });
 
+  test("skills action lines hide apply actions when no update is available", () => {
+    expect(buildActionLines("Skills", { updateAvailable: false })).toEqual([
+      "f: filter list",
+      "p: pin selected",
+      "space: toggle select",
+      "i: install selected",
+      "r: remove selected",
+      "z: undo last add/remove",
+      "L: run history",
+      "v: show SKILL",
+      "g: run",
+      "G: run options",
+      "u: check updates",
+      "a: add skill",
+      "d: doctor",
+      "T: test popup",
+      "c: reload config",
+      "H: help",
+      "Tab: next panel",
+      "Arrow keys: move",
+      "q: quit",
+    ]);
+  });
+
   test("discover help lines stay stable", () => {
     expect(buildHelpLines("Discover")).toEqual([
       "Discover lists skills from skills.json.",

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/test/render_actions_service.test.ts

@@ -13,6 +13,7 @@ describe("render actions service", () => {
     renderActionsWithUi({
       tab: "Discover",
       rowCount: lines.length,
+      updateAvailable: false,
       lines,
     });
 

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/test/runtime_handlers.test.ts

@@ -223,4 +223,15 @@ describe("runtime key handler", () => {
     expect(calls.openRunHistory).toBe(1);
     expect(calls.undoLastAction).toBe(1);
   });
+
+  test("invalid action key on active tab is ignored without blocking next input", () => {
+    const { state, calls, handleKey } = createDeps();
+    state.tabIndex = 1; // Discover tab
+
+    expect(handleKey("r")).toBe(false);
+    expect(calls.enterInputMode).toHaveLength(0);
+
+    expect(handleKey("f")).toBe(true);
+    expect(calls.enterInputMode).toEqual([{ mode: "filter", seed: "" }]);
+  });
 });

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/test/ui_controller.test.ts

@@ -88,7 +88,7 @@ describe("three-pane render snapshots", () => {
       selectedIndex: 1,
       list: ["  alpha - org/repo", "> alpha - org/other", ""],
       details: ["Name: alpha", "Source: org/other", "Handle: org/other/alpha", "Repo: org/other", ""],
-      actions: ["f: filter list", "p: pin selected", "i: add selected", "r: remove selected", "z: undo last add/remove"],
+      actions: ["f: filter list", "p: pin selected", "i: add selected", "z: undo last add/remove", "L: run history"],
     });
   });
 });

{agr_opentui-0.2.1 → agr_opentui-0.3.1}/uv.lock

@@ -1,6 +1,6 @@
 version = 1
 revision = 3
-requires-python = ">=3.14"
+requires-python = ">=3.14.3"
 
 [[package]]
 name = "agr"
@@ -19,7 +19,7 @@ wheels = [
 
 [[package]]
 name = "agr-opentui"
-version = "0.2.1"
+version = "0.3.1"
 source = { editable = "." }
 dependencies = [
     { name = "agr" },