agr-opentui 0.2.0__tar.gz

agr_opentui-0.2.0/.github/renovate.json5

@@ -0,0 +1,19 @@
+{
+  $schema: "https://docs.renovatebot.com/renovate-schema.json",
+  extends: [
+    "config:recommended",
+    ":dependencyDashboard",
+    ":automergeMinor"
+  ],
+  timezone: "UTC",
+  schedule: ["before 6am on monday"],
+  labels: ["dependencies"],
+  rangeStrategy: "bump",
+  packageRules: [
+    {
+      matchManagers: ["npm"],
+      matchUpdateTypes: ["major"],
+      automerge: false
+    }
+  ]
+}

agr_opentui-0.2.0/.github/workflows/build-bin.yml

@@ -0,0 +1,75 @@
+name: build-bin
+
+on:
+  workflow_dispatch:
+  release:
+    types: [published]
+
+jobs:
+  build-linux:
+    runs-on: ubuntu-latest
+    env:
+      BASE_NAME: agr-opentui
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@3d267786b128fe76c2f16a390aa2448b815359f3 # v2.1.2
+        with:
+          bun-version: '1.3.8'
+
+      - name: Cache Bun dependencies
+        uses: actions/cache@cdf6c1fa76f9f475f3d7449005a359c84ca0f306 # v5.0.3
+        with:
+          path: |
+            ~/.bun/install/cache
+            node_modules
+          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-
+
+      - name: Install deps
+        run: bun install
+
+      - name: Build binary
+        run: make build
+
+      - name: Compute artifact name
+        id: name
+        shell: bash
+        run: |
+          sanitize() {
+            local value="$1"
+            value="${value//\//-}"
+            value="${value//_/-}"
+            echo "$value"
+          }
+
+          ref="${GITHUB_REF#refs/heads/}"
+          if [[ "${GITHUB_REF}" == refs/tags/* ]]; then
+            tag="${GITHUB_REF#refs/tags/}"
+            safe_tag="$(sanitize "$tag")"
+            name="${BASE_NAME}-tag-${safe_tag}"
+          elif [[ "${ref}" == "master" ]]; then
+            name="${BASE_NAME}"
+          else
+            safe_ref="$(sanitize "$ref")"
+            name="${BASE_NAME}-branch-${safe_ref}"
+          fi
+          echo "name=${name}" >> "$GITHUB_OUTPUT"
+
+      - name: Rename binary
+        run: mv bin/agr-tui "bin/${{ steps.name.outputs.name }}"
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
+        with:
+          name: ${{ steps.name.outputs.name }}-linux
+          path: bin/${{ steps.name.outputs.name }}
+
+      - name: Upload to release
+        if: github.event_name == 'release'
+        uses: softprops/action-gh-release@a06a81a03ee405af7f2048a818ed3f03bbf83c7b # v2.5.0
+        with:
+          files: bin/${{ steps.name.outputs.name }}

agr_opentui-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: ci
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  lint-workflows:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Lint GitHub workflows
+        uses: rhysd/actionlint@0933c147c9d6587653d45fdcb4c497c57a65f9af # v1.7.10
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@3d267786b128fe76c2f16a390aa2448b815359f3 # v2.1.2
+        with:
+          bun-version: "1.3.8"
+
+      - name: Cache Bun dependencies
+        uses: actions/cache@cdf6c1fa76f9f475f3d7449005a359c84ca0f306 # v5.0.3
+        with:
+          path: |
+            ~/.bun/install/cache
+            node_modules
+          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Run checks
+        run: bun run check
+
+      - name: Build binary
+        run: bun run build
+
+      - name: Run strict unused checks
+        run: bunx tsc --noEmit --noUnusedLocals --noUnusedParameters

agr_opentui-0.2.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,76 @@
+name: publish-pypi
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      target:
+        description: "Where to publish the package"
+        required: true
+        type: choice
+        options:
+          - pypi
+          - testpypi
+        default: pypi
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.14.3"
+
+      - name: Build package
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
+        with:
+          name: python-dist
+          path: dist/
+
+  publish-pypi:
+    if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && inputs.target == 'pypi')
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v7
+        with:
+          name: python-dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-testpypi:
+    if: github.event_name == 'workflow_dispatch' && inputs.target == 'testpypi'
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment:
+      name: testpypi
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v7
+        with:
+          name: python-dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

agr_opentui-0.2.0/.gitignore

@@ -0,0 +1,34 @@
+node_modules/
+dist/
+bin/
+.tmp/
+.cache/
+*.log
+.env
+.env.*
+.DS_Store
+__pycache__/
+*.py[cod]
+.python-version
+.venv/
+venv/
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+.coverage
+coverage/
+htmlcov/
+.idea/
+.vscode/
+*.tsbuildinfo
+*.pid
+*.pid.lock
+.bun/
+*.tmp
+*.swp
+*.swo
+/tmp/
+.uv/
+.claude/
+.agents/
+agr.toml

agr_opentui-0.2.0/Makefile

@@ -0,0 +1,34 @@
+BUN ?= bun
+PYTHON ?= python3
+ENTRY ?= src/main.ts
+OUT_DIR ?= bin
+OUT ?= $(OUT_DIR)/agr-tui
+DIST_DIR ?= dist
+
+.PHONY: build clean
+.PHONY: test check
+.PHONY: py-build py-publish py-publish-test
+
+build:
+	@mkdir -p $(OUT_DIR)
+	$(BUN) build $(ENTRY) --compile --outfile $(OUT)
+
+test:
+	$(BUN) test
+
+check:
+	$(BUN) run typecheck
+	$(BUN) test
+
+py-build:
+	rm -rf $(DIST_DIR)
+	$(PYTHON) -m build
+
+py-publish: py-build
+	$(PYTHON) -m twine upload $(DIST_DIR)/*
+
+py-publish-test: py-build
+	$(PYTHON) -m twine upload --repository testpypi $(DIST_DIR)/*
+
+clean:
+	rm -rf $(OUT_DIR)

agr_opentui-0.2.0/PKG-INFO

@@ -0,0 +1,6 @@
+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/README.md

@@ -0,0 +1,144 @@
+# 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
+
+- Bun 1.3.8+
+- Zig (required by OpenTUI build tooling)
+- Python 3.10+
+- `uv`
+- `agr` + `agrx` on your `PATH`
+
+## 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
+```
+
+## 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/__init__.py

@@ -0,0 +1 @@
+"""OpenTUI bridge package for agr."""

agr_opentui-0.2.0/agr_opentui/bridge.py

@@ -0,0 +1,157 @@
+"""JSON bridge for the OpenTUI interface."""
+
+from __future__ import annotations
+
+import argparse
+import json
+from dataclasses import dataclass
+from pathlib import Path
+
+from agr.config import AgrConfig, Dependency, find_config, find_repo_root
+from agr.fetcher import get_installed_skills
+from agr.handle import ParsedHandle, parse_handle
+from agr.skill import SKILL_MARKER
+from agr.tool import get_tool
+
+
+@dataclass(frozen=True)
+class BridgeDependency:
+    identifier: str
+    handle: str | None
+    path: str | None
+    is_local: bool
+    display: str
+    candidates: list[str]
+    candidates_by_tool: dict[str, list[str]]
+    installed: bool
+    skill_md_path: str | None
+
+
+def _parse_dependency(dep: Dependency) -> ParsedHandle:
+    if dep.handle:
+        return parse_handle(dep.handle, prefer_local=False)
+    if dep.path:
+        path = Path(dep.path)
+        return ParsedHandle(is_local=True, name=path.name, local_path=path)
+    raise ValueError("Dependency missing handle/path")
+
+
+def _candidates_for_install(handle: ParsedHandle, tool_name: str) -> list[str]:
+    tool = get_tool(tool_name)
+    candidates = [
+        handle.to_skill_path(tool).as_posix(),
+        handle.name,
+        handle.to_installed_name(),
+    ]
+    if handle.is_local:
+        candidates.append(f"local/{handle.name}")
+    return list(dict.fromkeys(candidates))
+
+
+def _installed_by_tool(repo_root: Path, tools: list[str]) -> dict[str, list[str]]:
+    installed: dict[str, list[str]] = {}
+    for tool in tools:
+        try:
+            installed[tool] = get_installed_skills(repo_root, get_tool(tool))
+        except Exception:
+            installed[tool] = []
+    return installed
+
+
+def _resolve_skill_md_path(
+    dep: Dependency,
+    *,
+    handle: ParsedHandle,
+    repo_root: Path | None,
+    default_tool: str | None,
+) -> str | None:
+    if repo_root is None:
+        return None
+
+    if dep.path:
+        path = Path(dep.path)
+        if not path.is_absolute():
+            path = repo_root / path
+        skill_md = path / SKILL_MARKER
+        return str(skill_md) if skill_md.exists() else None
+
+    if not default_tool:
+        return None
+
+    tool = get_tool(default_tool)
+    skills_dir = tool.get_skills_dir(repo_root)
+    candidates = _candidates_for_install(handle, default_tool)
+    for candidate in candidates:
+        skill_md = skills_dir / candidate / SKILL_MARKER
+        if skill_md.exists():
+            return str(skill_md)
+    return None
+
+
+def build_payload() -> dict[str, object]:
+    repo_root = find_repo_root()
+    config_path = find_config()
+    config = AgrConfig.load(config_path) if config_path else AgrConfig()
+
+    tool_names = list(config.tools)
+    default_tool = config.default_tool or (tool_names[0] if tool_names else None)
+
+    installed = (
+        _installed_by_tool(repo_root, tool_names) if repo_root and tool_names else {}
+    )
+
+    deps_payload: list[dict[str, object]] = []
+    for dep in config.dependencies:
+        handle = _parse_dependency(dep)
+        candidates = (
+            _candidates_for_install(handle, default_tool)
+            if default_tool
+            else []
+        )
+        candidates_by_tool = {
+            tool_name: _candidates_for_install(handle, tool_name)
+            for tool_name in tool_names
+        }
+        installed_names = installed.get(default_tool or "", [])
+        is_installed = any(name in installed_names for name in candidates)
+        skill_md_path = _resolve_skill_md_path(
+            dep,
+            handle=handle,
+            repo_root=repo_root,
+            default_tool=default_tool,
+        )
+
+        deps_payload.append(
+            BridgeDependency(
+                identifier=dep.identifier,
+                handle=dep.handle,
+                path=dep.path,
+                is_local=dep.is_local,
+                display=dep.identifier,
+                candidates=candidates,
+                candidates_by_tool=candidates_by_tool,
+                installed=is_installed,
+                skill_md_path=skill_md_path,
+            ).__dict__
+        )
+
+    return {
+        "repo_root": str(repo_root) if repo_root else None,
+        "config_path": str(config_path) if config_path else None,
+        "tools": tool_names,
+        "default_tool": default_tool,
+        "dependencies": deps_payload,
+        "installed": installed,
+    }
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="OpenTUI data bridge")
+    parser.parse_args()
+
+    payload = build_payload()
+    print(json.dumps(payload))
+
+
+if __name__ == "__main__":
+    main()