agr-opentui 0.2.2__py3-none-any.whl → 0.3.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: agr-opentui
3
- Version: 0.2.2
3
+ Version: 0.3.1
4
4
  Summary: OpenTUI frontend for agr
5
5
  Project-URL: Homepage, https://github.com/RelativeSure/agr-opentui
6
6
  Project-URL: Repository, https://github.com/RelativeSure/agr-opentui
@@ -17,13 +17,25 @@ Classifier: Programming Language :: Python :: 3
17
17
  Classifier: Programming Language :: Python :: 3.14
18
18
  Classifier: Topic :: Software Development :: Build Tools
19
19
  Classifier: Topic :: Utilities
20
- Requires-Python: >=3.14
20
+ Requires-Python: >=3.14.3
21
21
  Requires-Dist: agr>=0.7.4
22
22
  Description-Content-Type: text/markdown
23
23
 
24
- # OpenTUI for agr
24
+ <div align="center">
25
25
 
26
- 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`.
26
+ # OpenTUI for `agr` and `agrx`
27
+
28
+ An OpenTUI interface for the `agr`/`agrx` CLI: view configured skills, trigger `agr` actions and preview `SKILL.md`
29
+
30
+ [![PyPI](https://img.shields.io/pypi/v/agr-opentui?color=blue)](https://pypi.org/project/agr-opentui/)
31
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
32
+
33
+ </div>
34
+
35
+ ---
36
+
37
+ `agr-opentui` is an OpenTUI front-end for `agr`/`agrx`.
38
+ The default discover source in this repo points to `https://github.com/kasperjunge/agent-resources`.
27
39
 
28
40
  ## Usage
29
41
 
@@ -83,98 +95,50 @@ Discover flow:
83
95
 
84
96
  ## Requirements
85
97
 
86
- Runtime (using `agr-tui`):
98
+ ### Runtime (using `agr-tui`):
87
99
  - Python 3.10+
88
100
  - `uv`
89
101
  - `agr` + `agrx` on your `PATH`
90
102
 
91
- Build/Development (working on this repo):
103
+ ### Build/Development (working on this repo):
92
104
  - Bun 1.3.8+
93
105
  - Zig (required by OpenTUI build tooling)
94
106
 
95
- ## Install
96
-
97
- ```bash
98
- bun install
99
- ```
100
-
101
- ## Run
107
+ #### Build
102
108
 
103
109
  ```bash
104
- bun run src/main.ts
105
- ```
106
-
107
- Run it from the repo you want to manage (the current working directory is the target repo).
108
- `agr.toml` is expected in that target repo for `agr add/remove/sync` operations.
109
-
110
- ### Run From Target Repo
111
-
112
- ```bash
113
- cd /path/to/your/project
114
- agr-tui
110
+ bun run build
115
111
  ```
116
-
117
- `agr-opentui` itself does not need to contain your target repo's `agr.toml`.
118
-
119
- ## Build
120
-
112
+ or
121
113
  ```bash
122
- bun run build
114
+ make build
123
115
  ```
124
-
125
116
  This creates `bin/agr-tui`.
126
117
 
127
- ## Publish to PyPI
128
-
129
- One-time setup:
130
- - Create a `pypi` environment in this GitHub repo.
131
- - In your PyPI project settings, add this repo/workflow as a Trusted Publisher for `.github/workflows/publish-pypi.yml`.
132
- - Optional: add `testpypi` environment and TestPyPI Trusted Publisher too.
133
118
 
134
- Publish via GitHub Actions:
135
- - Release publish: creating a GitHub release triggers publish to PyPI.
136
- - Manual: run `publish-pypi` workflow and choose `pypi` or `testpypi`.
137
-
138
- Publish from local machine:
119
+ #### Install
139
120
 
140
121
  ```bash
141
- python -m pip install --upgrade build twine
142
- make py-publish # Upload to PyPI
143
- make py-publish-test # Upload to TestPyPI
122
+ bun install
144
123
  ```
145
124
 
146
- ## Bump Version
147
-
148
- Update package version before creating a release:
149
-
150
- 1. Edit `pyproject.toml` and bump `[project].version`.
151
- 2. Regenerate `uv.lock` so the local package entry matches:
125
+ #### Run
152
126
 
153
127
  ```bash
154
- uv lock
128
+ bun run src/main.ts
155
129
  ```
156
130
 
157
- 3. Run checks:
158
-
159
- ```bash
160
- make check
161
- ```
131
+ Run it from the repo you want to manage (the current working directory is the target repo).
132
+ `agr.toml` is expected in that target repo for `agr add/remove/sync` operations.
162
133
 
163
- 4. Commit the version bump:
134
+ ### Run From Target Repo
164
135
 
165
136
  ```bash
166
- git add pyproject.toml uv.lock
167
- git commit -m "chore: bump version to X.Y.Z"
137
+ cd /path/to/your/project
138
+ agr-tui
168
139
  ```
169
140
 
170
- 5. Create a GitHub release for `vX.Y.Z` (or manually run `publish-pypi` workflow).
171
-
172
- `publish-pypi.yml` runs automatically when a release is published.
173
-
174
- Alternative: use `.github/workflows/bump-version.yml` via **Actions → bump-version → Run workflow** and provide:
175
- - `version` (required): target version like `0.3.0`
176
- - `branch` (required): target branch to update (default `master`)
177
- - `create_tag` (required, default enabled): creates/pushes tag `v<version>` and creates a GitHub Release
141
+ `agr-opentui` itself does not need to contain your target repo's `agr.toml`.
178
142
 
179
143
  ## Discover List (`skills.json`)
180
144
 
@@ -183,6 +147,8 @@ If `skills.json` exists, the `Discover` tab will list its entries. It supports:
183
147
  - An array of strings or objects (`{ "label": "...", "handle": "...", "repo": "owner/repo" }`).
184
148
  - An object with `source` metadata and `skills` array (see `skills.json` in this repo).
185
149
 
150
+ In this repository, `skills.json` is configured to source skills from `kasperjunge/agent-resources` (`agr.toml` on `main`).
151
+
186
152
  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.
187
153
 
188
154
  ## Troubleshooting
@@ -194,7 +160,6 @@ When a `source` is configured, the app checks the remote list periodically (abou
194
160
  - `skills.json not found` or parse errors: fix the file format (array or `{ "source": ..., "skills": [...] }`).
195
161
  - Discover list not updating: check the `source` URL/repo/branch/path and network access.
196
162
  - `SKILL.md` preview says “not found”: the skill may not ship a `SKILL.md` or the path is nonstandard.
197
- - Copy to clipboard doesn’t work: install `pbcopy` (macOS), `wl-copy` (Wayland), or `xclip` (X11).
198
163
 
199
164
  ## Notes
200
165
 
@@ -0,0 +1,5 @@
1
+ agr_opentui/__init__.py,sha256=noLIoaeF0mg3fcx2LNZjDFKGS7ioA-FDCxKLIdM0v8w,38
2
+ agr_opentui/bridge.py,sha256=NmhjSq8jSvxttue0iHV8F484pfaCDMXaVlWz3qTugZw,4551
3
+ agr_opentui-0.3.1.dist-info/METADATA,sha256=HpkiyEqIepT-u7_q9RHtcrmkNzR4eoIwguMqZLDNpaQ,4835
4
+ agr_opentui-0.3.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
5
+ agr_opentui-0.3.1.dist-info/RECORD,,
@@ -1,5 +0,0 @@
1
- agr_opentui/__init__.py,sha256=noLIoaeF0mg3fcx2LNZjDFKGS7ioA-FDCxKLIdM0v8w,38
2
- agr_opentui/bridge.py,sha256=NmhjSq8jSvxttue0iHV8F484pfaCDMXaVlWz3qTugZw,4551
3
- agr_opentui-0.2.2.dist-info/METADATA,sha256=KBPEk-kE886LJGHVH3IxTWfeVxjXjLal556VXYNUrrU,5928
4
- agr_opentui-0.2.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
5
- agr_opentui-0.2.2.dist-info/RECORD,,