agr-opentui 0.2.2__py3-none-any.whl → 0.3.2__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.2
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,45 @@ 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`.
39
+
40
+ ## Install from PyPI
41
+
42
+ With `uv`:
43
+
44
+ ```bash
45
+ uv tool install agr-opentui
46
+ ```
47
+
48
+ With `pip`:
49
+
50
+ ```bash
51
+ python -m pip install agr-opentui
52
+ ```
53
+
54
+ Then run:
55
+
56
+ ```bash
57
+ agr-opentui
58
+ ```
27
59
 
28
60
  ## Usage
29
61
 
@@ -83,98 +115,50 @@ Discover flow:
83
115
 
84
116
  ## Requirements
85
117
 
86
- Runtime (using `agr-tui`):
118
+ ### Runtime (using `agr-opentui`):
87
119
  - Python 3.10+
88
120
  - `uv`
89
121
  - `agr` + `agrx` on your `PATH`
90
122
 
91
- Build/Development (working on this repo):
123
+ ### Build/Development (working on this repo):
92
124
  - Bun 1.3.8+
93
125
  - Zig (required by OpenTUI build tooling)
94
126
 
95
- ## Install
96
-
97
- ```bash
98
- bun install
99
- ```
100
-
101
- ## Run
102
-
103
- ```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
115
- ```
116
-
117
- `agr-opentui` itself does not need to contain your target repo's `agr.toml`.
118
-
119
- ## Build
127
+ #### Build
120
128
 
121
129
  ```bash
122
130
  bun run build
123
131
  ```
124
-
125
- This creates `bin/agr-tui`.
126
-
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
-
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:
139
-
132
+ or
140
133
  ```bash
141
- python -m pip install --upgrade build twine
142
- make py-publish # Upload to PyPI
143
- make py-publish-test # Upload to TestPyPI
134
+ make build
144
135
  ```
136
+ This creates `bin/agr-opentui`.
145
137
 
146
- ## Bump Version
147
138
 
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:
139
+ #### Install
152
140
 
153
141
  ```bash
154
- uv lock
142
+ bun install
155
143
  ```
156
144
 
157
- 3. Run checks:
145
+ #### Run
158
146
 
159
147
  ```bash
160
- make check
148
+ bun run src/main.ts
161
149
  ```
162
150
 
163
- 4. Commit the version bump:
151
+ Run it from the repo you want to manage (the current working directory is the target repo).
152
+ `agr.toml` is expected in that target repo for `agr add/remove/sync` operations.
153
+
154
+ ### Run From Target Repo
164
155
 
165
156
  ```bash
166
- git add pyproject.toml uv.lock
167
- git commit -m "chore: bump version to X.Y.Z"
157
+ cd /path/to/your/project
158
+ agr-opentui
168
159
  ```
169
160
 
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
161
+ `agr-opentui` itself does not need to contain your target repo's `agr.toml`.
178
162
 
179
163
  ## Discover List (`skills.json`)
180
164
 
@@ -183,6 +167,8 @@ If `skills.json` exists, the `Discover` tab will list its entries. It supports:
183
167
  - An array of strings or objects (`{ "label": "...", "handle": "...", "repo": "owner/repo" }`).
184
168
  - An object with `source` metadata and `skills` array (see `skills.json` in this repo).
185
169
 
170
+ In this repository, `skills.json` is configured to source skills from `kasperjunge/agent-resources` (`agr.toml` on `main`).
171
+
186
172
  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
173
 
188
174
  ## Troubleshooting
@@ -194,7 +180,6 @@ When a `source` is configured, the app checks the remote list periodically (abou
194
180
  - `skills.json not found` or parse errors: fix the file format (array or `{ "source": ..., "skills": [...] }`).
195
181
  - Discover list not updating: check the `source` URL/repo/branch/path and network access.
196
182
  - `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
183
 
199
184
  ## Notes
200
185
 
@@ -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.2.dist-info/METADATA,sha256=SyIbYtMcTzC3ktcdPbXBkar0KRwFLgg19CPvBftpkrk,5018
4
+ agr_opentui-0.3.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
5
+ agr_opentui-0.3.2.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,,