agy-powerline 1.3.0 → 1.5.0

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.
Files changed (22) hide show
  1. package/CHANGELOG.md +55 -1
  2. package/README.fr.md +87 -32
  3. package/README.ja.md +87 -32
  4. package/README.md +89 -34
  5. package/README.zh-CN.md +87 -32
  6. package/llms.txt +127 -0
  7. package/package.json +8 -3
  8. package/src/cli/configure.js +70 -36
  9. package/src/cli/doctor.js +17 -1
  10. package/src/index.js +2 -1
  11. package/src/lib/catalog.js +21 -0
  12. package/src/lib/colors.js +17 -14
  13. package/src/lib/config.js +72 -20
  14. package/src/lib/fit.js +3 -0
  15. package/src/lib/formatters.js +107 -4
  16. package/src/lib/git.js +14 -5
  17. package/src/lib/layouts/lines.js +87 -22
  18. package/src/lib/layouts/pills.js +120 -33
  19. package/src/lib/session.js +49 -1
  20. package/src/lib/shared.js +2 -1
  21. package/src/lib/widget-options.js +108 -14
  22. package/src/lib/widget-style.js +112 -10
package/CHANGELOG.md CHANGED
@@ -5,7 +5,61 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
- ## [Unreleased]
8
+ ## [1.5.0] - 2026-10-21
9
+
10
+ ### Added
11
+
12
+ - Folder depth for `cwd` and per-widget maximum widths for selected values (#98, thanks @dannyward630)
13
+ - Per-widget quota and context visibility thresholds in the bar and `configure` (#99, thanks @dannyward630)
14
+ - `clock` widget shows the current local time, in the 12/24-hour format set under `clock` (#46, thanks @Ashuge11)
15
+ - Optional `os` widget shows Windows, macOS, Linux or WSL (#63, thanks @dannyward630)
16
+ - Opt-in `host` widget shows the current user and short hostname; `doctor` shows them as `user@host`, since its output gets pasted into issues (#62, thanks @dannyward630)
17
+ - Every widget takes its own `label` and `icon`, in the config file and in `configure` (Label text, Icon) (#97)
18
+ - `llms.txt` in the package: install, commands, widgets, themes and presets in one file for AI assistants (#130, thanks @dannyward630)
19
+
20
+ ### Fixed
21
+
22
+ - `cwd` widget shows a path written for another OS (a Windows path on Linux or WSL, a POSIX path on Windows) as it is, instead of joining it to the current folder (#134, thanks @dannyward630)
23
+
24
+ ## [1.4.0] - 2026-10-20
25
+
26
+ ### Added
27
+
28
+ - `rings` meter style (`●●●○○○`) and `ramp` meter style (`███░░░`, each filled cell shaded from the theme's ok color through caution to danger); pick them with `"meterStyle"` or per widget in `configure`
29
+ - `classic` layout: plain colored text with `|` dividers and block meters (`███░│░░░░░`); `npx agy-powerline layout classic` or `l` in `configure`
30
+ - CodeQL static code analysis workflow (`.github/workflows/codeql.yml`)
31
+ - README badges for the live web configurator, GitHub stars, CodeQL, and OS platform logos
32
+ - Star History chart in READMEs
33
+ - `git` preset (project, branch, worktree, stash; changed files and lines, commit) and `tokens` preset (session tokens, cache hit, tokens today and over 7 days)
34
+ - Each GitHub release has plugin archives attached (`agy-powerline-plugin-<version>.zip` and `.tar.gz`), for `agy plugin install` where npm or cloning from GitHub is blocked; `docs/install.md` → Install without npm (#123)
35
+
36
+ ### Changed
37
+
38
+ - Space between rows (`"rowGap"`, `v` in `configure`) works in every layout, not only Pills
39
+ - Pills draw meters as small dots (`pips`), with a larger dot as the pace marker, instead of solid colored blocks; `"meterStyle": "cells"` keeps the blocks, and ASCII mode keeps them too
40
+ - The setup and customize skills run commands from the plugin's own copy when npx can't reach npm (#123)
41
+ - `configure` → Themes shows a theme's palette in two columns with space between the pills
42
+ - Presets are named after what they show: Default, Compact, Agent activity, Git focus, Token usage, Quota watch and Everything
43
+ - The `workspace` preset is now `agent` (agent state, subagents, title, mode and sandbox; model, context %, artifacts, tightest quota), and `limits` is now `quotas`, in three rows: plan and model, then the 5h and 7d quotas side by side, then third-party and Argon
44
+
45
+ ### Removed
46
+
47
+ - The preset names `workspace` and `limits`: use `agent` and `quotas`. `preset workspace`, `preset limits` and `init --preset` with either name stop with an error that lists the presets; saved configs keep working
48
+
49
+ ### Fixed
50
+
51
+ - In the Pills layout, two neighboring widgets of the same color (a quota meter and its reset) are divided by a thin line instead of a solid black arrow or half-circle
52
+ - Pill caps and separators are no longer drawn in bold, which some fonts draw wider or shifted
53
+ - The flat style (no end caps) no longer paints the space after a pill in that pill's color
54
+ - With joins off, a row's pills sit one space apart and only Flex Separators spread them, instead of every gap stretching
55
+ - Without color, pills no longer show solid caps and joins as blocks of text color
56
+ - ASCII joins (`>`) are drawn in the text color, readable on any pill
57
+ - In 256-color mode, colors map to the nearest terminal color (near-black text was navy blue), and widgets whose colors land on the same code get a visible divider
58
+
59
+ ### Security
60
+
61
+ - Each GitHub release has the npm tarball attached with its signed build attestation; check it with `gh attestation verify` (see `SECURITY.md`) (#117)
62
+ - The plugin archives on each release have the same signed build attestation as the tarball (#123)
9
63
 
10
64
  ## [1.3.0] - 2026-10-18
11
65
 
package/README.fr.md CHANGED
@@ -2,14 +2,18 @@
2
2
 
3
3
  [English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | **Français**
4
4
 
5
- [![CI](https://github.com/wassim-azi/agy-powerline/actions/workflows/ci.yml/badge.svg)](https://github.com/wassim-azi/agy-powerline/actions/workflows/ci.yml)
6
5
  [![Version](https://img.shields.io/npm/v/agy-powerline.svg)](https://www.npmjs.com/package/agy-powerline)
7
- [![Downloads](https://img.shields.io/npm/dt/agy-powerline.svg)](https://www.npmjs.com/package/agy-powerline)
8
- [![Node](https://img.shields.io/badge/node-%3E%3D20-informational.svg)](https://nodejs.org/)
9
- [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-informational.svg)](docs/install.md)
10
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
11
- [![Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](#confidentialité-et-sécurité)
6
+ [![Downloads](https://img.shields.io/npm/d18m/agy-powerline.svg?cacheSeconds=86400)](https://www.npmjs.com/package/agy-powerline)
7
+ [![Stars](https://img.shields.io/github/stars/wassim-azi/agy-powerline?style=flat&color=gold&cacheSeconds=86400)](https://github.com/wassim-azi/agy-powerline/stargazers)
8
+ [![CI](https://github.com/wassim-azi/agy-powerline/actions/workflows/ci.yml/badge.svg)](https://github.com/wassim-azi/agy-powerline/actions/workflows/ci.yml)
9
+ [![CodeQL](https://github.com/wassim-azi/agy-powerline/actions/workflows/codeql.yml/badge.svg)](https://github.com/wassim-azi/agy-powerline/actions/workflows/codeql.yml)
12
10
  [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/wassim-azi/agy-powerline/badge)](https://scorecard.dev/viewer/?uri=github.com/wassim-azi/agy-powerline)
11
+ [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/15655/badge)](https://www.bestpractices.dev/projects/15655)
12
+ [![Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](#confidentialité-et-sécurité)
13
+ [![Platforms](https://img.shields.io/badge/platforms-Windows%20%7C%20macOS%20%7C%20Linux-0078D6.svg)](docs/install.md)
14
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
15
+ [![Open in GitHub Codespaces](https://img.shields.io/badge/open%20in-Codespaces-24292f.svg?logo=github&logoColor=white)](https://codespaces.new/wassim-azi/agy-powerline?quickstart=1)
16
+ [![Web Configurator](https://img.shields.io/badge/web%20configurator-live-00dc82.svg)](https://agy-powerline.com/configure/)
13
17
  [![Mentioned in Awesome Gemini CLI](https://img.shields.io/badge/mentioned%20in-awesome-fc60a8.svg?logo=awesomelists&logoColor=white)](https://github.com/Piebald-AI/awesome-gemini-cli)
14
18
 
15
19
  > > **Remarque :** cette traduction peut ne pas être à jour. En cas de divergence, la [version anglaise](README.md) fait foi. La documentation détaillée ([`docs/`](docs/)) n’existe qu’en anglais.
@@ -19,7 +23,7 @@
19
23
  Consultez d’un coup d’œil le modèle utilisé, les quotas Gemini sur 5h/7d, ceux de Claude/GPT et d’Argon, la fenêtre de contexte, la branche Git et bien plus encore. Choisissez les widgets, les thèmes et la disposition dans un éditeur interactif. Une seule commande suffit pour l’installation, sans aucune dépendance.
20
24
 
21
25
  <p align="center">
22
- <img src="assets/screenshots/pills-dark.png" alt="Disposition Pills d’agy-powerline avec le thème dark-ocean : état de l’agent, modèle, plan, projet et Git ; contexte ; quotas sur 5h et 7d avec leurs réinitialisations" width="850">
26
+ <img src="assets/demo.gif" alt="configure d’agy-powerline : ajout du quota hebdomadaire d’Argon en tapant argon, puis parcours des préréglages, des thèmes et des dispositions avec un aperçu en direct de la barre, et ouverture de l’onglet Powerline" width="850">
23
27
  </p>
24
28
 
25
29
  ## Installation
@@ -34,6 +38,15 @@ agy # start Antigravity
34
38
 
35
39
  Avant de remplacer quoi que ce soit, `init` demande confirmation et sauvegarde le fichier `settings.json` d’Antigravity. Redémarrez `agy` une fois après l’exécution de `init`. Pour en savoir plus, consultez [le fonctionnement de `init`](docs/install.md).
36
40
 
41
+ <details>
42
+ <summary>Capture : la barre dans une vraie session agy (Windows Terminal)</summary>
43
+
44
+ <p align="center">
45
+ <img src="assets/screenshots/windows.png" alt="agy-powerline sous la zone de saisie d’agy dans Windows Terminal : une courte conversation au-dessus, la barre Pills sur trois lignes en dessous" width="850">
46
+ </p>
47
+
48
+ </details>
49
+
37
50
  Vous pouvez aussi laisser agy effectuer l’installation : collez cette instruction dans une session `agy`.
38
51
 
39
52
  ```text
@@ -54,13 +67,15 @@ Les modifications s’appliquent à une session `agy` en cours lors de l’actua
54
67
 
55
68
  Choisissez un préréglage comme point de départ, puis personnalisez-le :
56
69
 
57
- | Préréglage | Informations affichées |
58
- | ----------- | --------------------------------------------------------------------------------------------------------- |
59
- | `default` | Modèle, contexte et Git ; quotas sur 5h et 7d avec leurs réinitialisations sur une deuxième ligne |
60
- | `compact` | Une seule ligne : nom abrégé du modèle, quota le plus proche de sa limite, pourcentage du contexte et Git |
61
- | `workspace` | Projet, Git, état de l’agent et modèle ; contexte, quota le plus proche de sa limite et mode |
62
- | `limits` | Tous les quotas (5h, 7d, modèles tiers, Argon), un par ligne |
63
- | `full` | Toutes les informations : session, projet et Git ; contexte, tokens et cache ; les deux quotas |
70
+ | Préréglage | Informations affichées |
71
+ | ---------- | --------------------------------------------------------------------------------------------------------------------- |
72
+ | `default` | Modèle, contexte et Git ; quotas sur 5h et 7d avec leurs réinitialisations sur une deuxième ligne |
73
+ | `compact` | Une seule ligne : nom abrégé du modèle, quota le plus proche de sa limite, pourcentage du contexte et Git |
74
+ | `agent` | État de l’agent, sous-agents, titre, mode, sandbox ; modèle, contexte %, artefacts, quota le plus proche de sa limite |
75
+ | `git` | Projet, branche, worktree, stash ; nombre de fichiers, lignes modifiées, commit |
76
+ | `tokens` | Tokens du contexte, tokens de la session en entrée et en sortie, cache ; tokens du jour et des 7 derniers jours |
77
+ | `quotas` | Forfait et modèle ; quotas sur 5h et 7d côte à côte ; modèles tiers et Argon sur une troisième ligne |
78
+ | `full` | Toutes les informations : session, projet et Git ; contexte, tokens et cache ; les deux quotas |
64
79
 
65
80
  ### Thèmes
66
81
 
@@ -78,21 +93,54 @@ Prévisualisez tous les thèmes avec `npx agy-powerline theme --gallery`.
78
93
  **Pills** (par défaut) : capsules de style powerline. Choisissez des formes arrondies, anguleuses, inclinées ou plates, et ajoutez éventuellement une ligne vide entre les lignes de la barre.
79
94
 
80
95
  <p align="center">
81
- <img src="assets/screenshots/pills-light.png" alt="Disposition Pills d’agy-powerline avec le thème light-sky sur un terminal clair et un espace entre les lignes" width="850">
96
+ <img src="assets/screenshots/pills-dark.png" alt="Disposition Pills d’agy-powerline avec le thème dark-aurora : modèle, contexte, projet et Git ; quotas Gemini sur 5h et 7d avec marqueurs de rythme et réinitialisations ; quotas hebdomadaires Claude/GPT et Argon" width="850">
97
+ </p>
98
+
99
+ <details>
100
+ <summary>Sur un terminal clair</summary>
101
+
102
+ <p align="center">
103
+ <img src="assets/screenshots/pills-light.png" alt="Disposition Pills d’agy-powerline avec le thème light-paper sur un terminal clair" width="850">
82
104
  </p>
83
105
 
106
+ </details>
107
+
84
108
  **Lines** : les mêmes informations sous forme de texte coloré classique.
85
109
 
86
110
  <p align="center">
87
- <img src="assets/screenshots/lines-dark.png" alt="Disposition Lines d’agy-powerline avec le thème dark-ocean sur un terminal sombre" width="850">
88
- <img src="assets/screenshots/lines-light.png" alt="Disposition Lines d’agy-powerline avec le thème light-sky sur un terminal clair" width="850">
111
+ <img src="assets/screenshots/lines-dark.png" alt="Disposition Lines d’agy-powerline avec le thème dark-aurora sur un terminal sombre" width="850">
89
112
  </p>
90
113
 
114
+ <details>
115
+ <summary>Sur un terminal clair</summary>
116
+
117
+ <p align="center">
118
+ <img src="assets/screenshots/lines-light.png" alt="Disposition Lines d’agy-powerline avec le thème light-paper sur un terminal clair" width="850">
119
+ </p>
120
+
121
+ </details>
122
+
123
+ **Classic** : du texte coloré séparé par des `|`, avec des jauges en blocs, comme `███░│░░░░░`.
124
+
125
+ <p align="center">
126
+ <img src="assets/screenshots/classic-dark.png" alt="Disposition Classic d’agy-powerline avec le thème dark-aurora sur un terminal sombre, avec des jauges en blocs" width="850">
127
+ </p>
128
+
129
+ <details>
130
+ <summary>Sur un terminal clair</summary>
131
+
132
+ <p align="center">
133
+ <img src="assets/screenshots/classic-light.png" alt="Disposition Classic d’agy-powerline avec le thème light-paper sur un terminal clair" width="850">
134
+ </p>
135
+
136
+ </details>
137
+
91
138
  ## Widgets
92
139
 
93
140
  | Widget | Informations affichées |
94
141
  | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
95
142
  | `model` | Modèle utilisé |
143
+ | `clock` | Current local time (12/24-hour format set under `clock`) |
96
144
  | `fiveHourBar`, `weeklyBar` | Quota restant sur 5h/7d sous forme de jauge, avec un [indicateur de rythme](docs/configuration.md#quota-pace-marker) |
97
145
  | `fiveHourPct`, `weeklyPct` | Pourcentage de quota restant sur 5h/7d |
98
146
  | `fiveHourReset`, `weeklyReset` | Temps restant avant la réinitialisation du quota, ou heure de réinitialisation |
@@ -110,27 +158,29 @@ Prévisualisez tous les thèmes avec `npx agy-powerline theme --gallery`.
110
158
  | `totalTokens`, `cacheHit`, `cacheRead`, `cacheCreate` | Tokens de la session et utilisation du cache des prompts |
111
159
  | `tokensToday`, `tokensWeek` | Tokens utilisés aujourd’hui et sur les 7 derniers jours, toutes conversations confondues (Node 22.13+) |
112
160
  | `ram` | Mémoire utilisée sur votre machine |
161
+ | `os` | System agy runs on: Windows, macOS, Linux or WSL |
162
+ | `host` | Current user and short hostname from the OS (`alex@devbox`) |
113
163
  | `customText`, `exec` | Texte personnalisé ou résultat d’une [commande shell](docs/configuration.md#shell-command-widget-exec) |
114
164
 
115
165
  Un widget qui n’a rien à afficher se masque automatiquement. Vous pouvez personnaliser sa couleur, masquer son libellé ou définir ses propres seuils d’alerte : consultez la [documentation de configuration](docs/configuration.md).
116
166
 
117
167
  ## Commandes
118
168
 
119
- | Commande | Fonction |
120
- | ----------------------------------------- | ---------------------------------------------------------------------- |
121
- | `npx agy-powerline init [--yes]` | Installer ou mettre à jour la barre d’état |
122
- | `npx agy-powerline configure` | Ouvrir l’éditeur (alias `config`) |
123
- | `npx agy-powerline preset <name>` | Appliquer un préréglage (`--list` pour afficher la liste) |
124
- | `npx agy-powerline theme <name>` | Changer de thème (`--list`, `--gallery`) |
125
- | `npx agy-powerline gradient <name>` | Color each row with a gradient (`--list`, `off`) |
126
- | `npx agy-powerline layout <pills\|lines>` | Changer de disposition |
127
- | `npx agy-powerline caps <style>` | Changer la forme des capsules : `round`, `angled`, `slanted`, `flat` |
128
- | `npx agy-powerline export [file]` | Save your config to a file, to back it up or share it |
129
- | `npx agy-powerline import <file>` | Load a config, after showing what changes (`--merge`) |
130
- | `npx agy-powerline doctor` | Vérifier l’installation et expliquer les éventuels problèmes |
131
- | `npx agy-powerline report` | Générer un rapport de bogue respectueux de la vie privée |
132
- | `npx agy-powerline uninstall [--delete]` | Retirer la barre d’état d’agy (`--delete` supprime aussi ses fichiers) |
133
- | `npx agy-powerline render --demo` | Afficher la barre avec des données d’exemple |
169
+ | Commande | Fonction |
170
+ | -------------------------------------------------- | ---------------------------------------------------------------------- |
171
+ | `npx agy-powerline init [--yes]` | Installer ou mettre à jour la barre d’état |
172
+ | `npx agy-powerline configure` | Ouvrir l’éditeur (alias `config`) |
173
+ | `npx agy-powerline preset <name>` | Appliquer un préréglage (`--list` pour afficher la liste) |
174
+ | `npx agy-powerline theme <name>` | Changer de thème (`--list`, `--gallery`) |
175
+ | `npx agy-powerline gradient <name>` | Color each row with a gradient (`--list`, `off`) |
176
+ | `npx agy-powerline layout <pills\|lines\|classic>` | Changer de disposition |
177
+ | `npx agy-powerline caps <style>` | Changer la forme des capsules : `round`, `angled`, `slanted`, `flat` |
178
+ | `npx agy-powerline export [file]` | Save your config to a file, to back it up or share it |
179
+ | `npx agy-powerline import <file>` | Load a config, after showing what changes (`--merge`) |
180
+ | `npx agy-powerline doctor` | Vérifier l’installation et expliquer les éventuels problèmes |
181
+ | `npx agy-powerline report` | Générer un rapport de bogue respectueux de la vie privée |
182
+ | `npx agy-powerline uninstall [--delete]` | Retirer la barre d’état d’agy (`--delete` supprime aussi ses fichiers) |
183
+ | `npx agy-powerline render --demo` | Afficher la barre avec des données d’exemple |
134
184
 
135
185
  Utilisez l’option `--help` avec n’importe quelle commande pour afficher les options disponibles.
136
186
 
@@ -174,6 +224,7 @@ Merci à toutes les personnes ayant contribué au projet :
174
224
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/yuefdev"><img src="https://avatars.githubusercontent.com/u/120668197?v=4&s=160" width="80" height="80" alt="Yusuf Efe"/><br /><sub><b>Yusuf Efe</b></sub></a></td>
175
225
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/hiyouwhatsapp"><img src="https://avatars.githubusercontent.com/u/89997383?v=4&s=160" width="80" height="80" alt="hiyouwhatsapp"/><br /><sub><b>hiyouwhatsapp</b></sub></a></td>
176
226
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/dharamdan01"><img src="https://avatars.githubusercontent.com/u/188893946?v=4&s=160" width="80" height="80" alt="dharamdan01"/><br /><sub><b>dharamdan01</b></sub></a></td>
227
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/Ashuge11"><img src="https://avatars.githubusercontent.com/u/210247942?v=4&s=160" width="80" height="80" alt="Ashvini Sundge"/><br /><sub><b>Ashvini Sundge</b></sub></a></td>
177
228
  </tr>
178
229
  </tbody>
179
230
  </table>
@@ -185,6 +236,10 @@ Merci à toutes les personnes ayant contribué au projet :
185
236
 
186
237
  Si agy-powerline vous est utile, une ⭐ permet à d’autres utilisateurs d’agy de le découvrir.
187
238
 
239
+ ## Star History
240
+
241
+ [![Star History Chart](https://api.star-history.com/svg?repos=wassim-azi/agy-powerline&type=Date)](https://star-history.com/#wassim-azi/agy-powerline&Date)
242
+
188
243
  ## Licence
189
244
 
190
245
  [MIT](LICENSE) © Wassim AZI
package/README.ja.md CHANGED
@@ -2,14 +2,18 @@
2
2
 
3
3
  [English](README.md) | [简体中文](README.zh-CN.md) | **日本語** | [Français](README.fr.md)
4
4
 
5
- [![CI](https://github.com/wassim-azi/agy-powerline/actions/workflows/ci.yml/badge.svg)](https://github.com/wassim-azi/agy-powerline/actions/workflows/ci.yml)
6
5
  [![Version](https://img.shields.io/npm/v/agy-powerline.svg)](https://www.npmjs.com/package/agy-powerline)
7
- [![Downloads](https://img.shields.io/npm/dt/agy-powerline.svg)](https://www.npmjs.com/package/agy-powerline)
8
- [![Node](https://img.shields.io/badge/node-%3E%3D20-informational.svg)](https://nodejs.org/)
9
- [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-informational.svg)](docs/install.md)
10
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
11
- [![Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](#プライバシーとセキュリティ)
6
+ [![Downloads](https://img.shields.io/npm/d18m/agy-powerline.svg?cacheSeconds=86400)](https://www.npmjs.com/package/agy-powerline)
7
+ [![Stars](https://img.shields.io/github/stars/wassim-azi/agy-powerline?style=flat&color=gold&cacheSeconds=86400)](https://github.com/wassim-azi/agy-powerline/stargazers)
8
+ [![CI](https://github.com/wassim-azi/agy-powerline/actions/workflows/ci.yml/badge.svg)](https://github.com/wassim-azi/agy-powerline/actions/workflows/ci.yml)
9
+ [![CodeQL](https://github.com/wassim-azi/agy-powerline/actions/workflows/codeql.yml/badge.svg)](https://github.com/wassim-azi/agy-powerline/actions/workflows/codeql.yml)
12
10
  [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/wassim-azi/agy-powerline/badge)](https://scorecard.dev/viewer/?uri=github.com/wassim-azi/agy-powerline)
11
+ [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/15655/badge)](https://www.bestpractices.dev/projects/15655)
12
+ [![Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](#プライバシーとセキュリティ)
13
+ [![Platforms](https://img.shields.io/badge/platforms-Windows%20%7C%20macOS%20%7C%20Linux-0078D6.svg)](docs/install.md)
14
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
15
+ [![Open in GitHub Codespaces](https://img.shields.io/badge/open%20in-Codespaces-24292f.svg?logo=github&logoColor=white)](https://codespaces.new/wassim-azi/agy-powerline?quickstart=1)
16
+ [![Web Configurator](https://img.shields.io/badge/web%20configurator-live-00dc82.svg)](https://agy-powerline.com/configure/)
13
17
  [![Mentioned in Awesome Gemini CLI](https://img.shields.io/badge/mentioned%20in-awesome-fc60a8.svg?logo=awesomelists&logoColor=white)](https://github.com/Piebald-AI/awesome-gemini-cli)
14
18
 
15
19
  > この文書は英語版 [README](README.md) の翻訳で、最新の内容に追いついていない場合があります。内容が異なる場合は英語版が優先されます。詳しいドキュメント（[`docs/`](docs/)）は英語版のみです。
@@ -19,7 +23,7 @@
19
23
  使用中のモデル、Gemini の 5h/7d・Claude/GPT・Argon のクォータ、コンテキストウィンドウ、git ブランチなどがひと目でわかります。ウィジェット、テーマ、レイアウトは対話式のエディターで選べます。インストールはコマンドひとつ、依存パッケージはありません。
20
24
 
21
25
  <p align="center">
22
- <img src="assets/screenshots/pills-dark.png" alt="dark-ocean テーマの agy-powerline Pills レイアウト：エージェントの状態、モデル、プラン、プロジェクト、git；コンテキスト；5h と 7d のクォータとリセットまでの時間" width="850">
26
+ <img src="assets/demo.gif" alt="agy-powerline の configure：argon と入力して Argon の週間クォータを追加し、プリセット、テーマ、レイアウトをバーのライブプレビューで見て回り、最後に Powerline タブを開く" width="850">
23
27
  </p>
24
28
 
25
29
  ## インストール
@@ -34,6 +38,15 @@ agy # Antigravity を起動
34
38
 
35
39
  `init` は何かを置き換える前に確認し、先に Antigravity の `settings.json` をバックアップします。`init` の後に `agy` を一度再起動してください。詳細：[`init` が行うこと](docs/install.md)。
36
40
 
41
+ <details>
42
+ <summary>スクリーンショット：実際の agy セッションでのバー（Windows Terminal）</summary>
43
+
44
+ <p align="center">
45
+ <img src="assets/screenshots/windows.png" alt="Windows Terminal で agy の入力欄の下に表示された agy-powerline：上に短い会話、下に 3 行の Pills バー" width="850">
46
+ </p>
47
+
48
+ </details>
49
+
37
50
  agy にインストールしてもらうこともできます。次の文を `agy` のセッションに貼り付けてください。
38
51
 
39
52
  ```text
@@ -54,13 +67,15 @@ Nerd Font のないターミナルでは、ASCII モードをオンにしてく
54
67
 
55
68
  プリセットから始めて、好みに合わせて調整します：
56
69
 
57
- | プリセット | 表示内容 |
58
- | ----------- | --------------------------------------------------------------------------------------------- |
59
- | `default` | モデル、コンテキスト、git；2 行目に 5h と 7d のクォータとリセットまでの時間 |
60
- | `compact` | 1 行：短いモデル名、最も残りの少ないクォータ、コンテキスト %、git |
61
- | `workspace` | プロジェクト、git、エージェントの状態、モデル；コンテキスト、最も残りの少ないクォータ、モード |
62
- | `limits` | すべてのクォータ（5h、7d、サードパーティ、Argon）を 1 行にひとつずつ |
63
- | `full` | すべて：セッション、プロジェクト、git；コンテキスト、トークン、キャッシュ；両方のクォータ |
70
+ | プリセット | 表示内容 |
71
+ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
72
+ | `default` | モデル、コンテキスト、git；2 行目に 5h と 7d のクォータとリセットまでの時間 |
73
+ | `compact` | 1 行：短いモデル名、最も残りの少ないクォータ、コンテキスト %、git |
74
+ | `agent` | エージェントの状態、サブエージェント、タイトル、モード、サンドボックス；モデル、コンテキスト %、アーティファクト、最も残りの少ないクォータ |
75
+ | `git` | プロジェクト、ブランチ、worktree、stash；ファイル数、変更行数、コミット |
76
+ | `tokens` | コンテキストのトークン、セッションの入出力トークン、キャッシュ；今日と 7 日間のトークン |
77
+ | `quotas` | プランとモデル；5h と 7d のクォータを横並びに、サードパーティと Argon を 3 行目に |
78
+ | `full` | すべて：セッション、プロジェクト、git；コンテキスト、トークン、キャッシュ；両方のクォータ |
64
79
 
65
80
  ### テーマ
66
81
 
@@ -78,21 +93,54 @@ Nerd Font のないターミナルでは、ASCII モードをオンにしてく
78
93
  **Pills**（デフォルト）：powerline 風のカプセル。形は丸型、山型、斜め、フラットから選べ、行の間に空行を入れることもできます。
79
94
 
80
95
  <p align="center">
81
- <img src="assets/screenshots/pills-light.png" alt="明るいターミナルでの light-sky テーマの agy-powerline Pills レイアウト、行間あり" width="850">
96
+ <img src="assets/screenshots/pills-dark.png" alt="dark-aurora テーマの agy-powerline Pills レイアウト：モデル、コンテキスト、プロジェクト、git；ペースマーカーとリセットまでの時間付きの Gemini 5h と 7d のクォータ；Claude/GPT と Argon の週間クォータ" width="850">
97
+ </p>
98
+
99
+ <details>
100
+ <summary>明るいターミナルの場合</summary>
101
+
102
+ <p align="center">
103
+ <img src="assets/screenshots/pills-light.png" alt="明るいターミナルでの light-paper テーマの agy-powerline Pills レイアウト" width="850">
82
104
  </p>
83
105
 
106
+ </details>
107
+
84
108
  **Lines**：同じ情報を色付きのプレーンテキストで表示します。
85
109
 
86
110
  <p align="center">
87
- <img src="assets/screenshots/lines-dark.png" alt="暗いターミナルでの dark-ocean テーマの agy-powerline Lines レイアウト" width="850">
88
- <img src="assets/screenshots/lines-light.png" alt="明るいターミナルでの light-sky テーマの agy-powerline Lines レイアウト" width="850">
111
+ <img src="assets/screenshots/lines-dark.png" alt="暗いターミナルでの dark-aurora テーマの agy-powerline Lines レイアウト" width="850">
89
112
  </p>
90
113
 
114
+ <details>
115
+ <summary>明るいターミナルの場合</summary>
116
+
117
+ <p align="center">
118
+ <img src="assets/screenshots/lines-light.png" alt="明るいターミナルでの light-paper テーマの agy-powerline Lines レイアウト" width="850">
119
+ </p>
120
+
121
+ </details>
122
+
123
+ **Classic**：`|` で区切ったプレーンな色付きテキストと、ブロックメーター（例：`███░│░░░░░`）。
124
+
125
+ <p align="center">
126
+ <img src="assets/screenshots/classic-dark.png" alt="暗いターミナルでの dark-aurora テーマの agy-powerline Classic レイアウト、ブロックメーター付き" width="850">
127
+ </p>
128
+
129
+ <details>
130
+ <summary>明るいターミナルの場合</summary>
131
+
132
+ <p align="center">
133
+ <img src="assets/screenshots/classic-light.png" alt="明るいターミナルでの light-paper テーマの agy-powerline Classic レイアウト" width="850">
134
+ </p>
135
+
136
+ </details>
137
+
91
138
  ## ウィジェット
92
139
 
93
140
  | ウィジェット | 表示内容 |
94
141
  | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
95
142
  | `model` | 使用中のモデル |
143
+ | `clock` | Current local time (12/24-hour format set under `clock`) |
96
144
  | `fiveHourBar`、`weeklyBar` | 5h / 7d クォータの残りをメーターで表示（[ペースマーカー](docs/configuration.md#quota-pace-marker)付き） |
97
145
  | `fiveHourPct`、`weeklyPct` | 5h / 7d クォータの残りをパーセントで表示 |
98
146
  | `fiveHourReset`、`weeklyReset` | クォータがリセットされるまでの時間、またはリセット時刻 |
@@ -110,27 +158,29 @@ Nerd Font のないターミナルでは、ASCII モードをオンにしてく
110
158
  | `totalTokens`、`cacheHit`、`cacheRead`、`cacheCreate` | セッションのトークン数とプロンプトキャッシュの使用状況 |
111
159
  | `tokensToday`、`tokensWeek` | 今日と過去 7 日間のトークン使用量（すべての会話、Node 22.13 以降） |
112
160
  | `ram` | マシンのメモリ使用量 |
161
+ | `os` | System agy runs on: Windows, macOS, Linux or WSL |
162
+ | `host` | Current user and short hostname from the OS (`alex@devbox`) |
113
163
  | `customText`、`exec` | 任意のテキスト、または [シェルコマンド](docs/configuration.md#shell-command-widget-exec)の出力 |
114
164
 
115
165
  表示する内容のないウィジェットは自動的に隠れます。ウィジェットごとに色を変えたり、ラベルを外したり、独自の警告しきい値を設定したりできます。詳しくは [Configuration](docs/configuration.md) を参照してください。
116
166
 
117
167
  ## コマンド
118
168
 
119
- | コマンド | 内容 |
120
- | ----------------------------------------- | ------------------------------------------------------------ |
121
- | `npx agy-powerline init [--yes]` | ステータスラインをインストールまたは更新 |
122
- | `npx agy-powerline configure` | エディターを開く（別名 `config`） |
123
- | `npx agy-powerline preset <name>` | プリセットを適用（一覧は `--list`） |
124
- | `npx agy-powerline theme <name>` | テーマを切り替え（`--list`、`--gallery`） |
125
- | `npx agy-powerline gradient <name>` | Color each row with a gradient (`--list`, `off`) |
126
- | `npx agy-powerline layout <pills\|lines>` | レイアウトを切り替え |
127
- | `npx agy-powerline caps <style>` | カプセルの形を切り替え：`round`、`angled`、`slanted`、`flat` |
128
- | `npx agy-powerline export [file]` | Save your config to a file, to back it up or share it |
129
- | `npx agy-powerline import <file>` | Load a config, after showing what changes (`--merge`) |
130
- | `npx agy-powerline doctor` | インストールを確認し、問題を説明 |
131
- | `npx agy-powerline report` | プライバシーに配慮したバグレポートを作成 |
132
- | `npx agy-powerline uninstall [--delete]` | agy から削除（`--delete` でファイルも削除） |
133
- | `npx agy-powerline render --demo` | サンプルデータでバーを表示 |
169
+ | コマンド | 内容 |
170
+ | -------------------------------------------------- | ------------------------------------------------------------ |
171
+ | `npx agy-powerline init [--yes]` | ステータスラインをインストールまたは更新 |
172
+ | `npx agy-powerline configure` | エディターを開く（別名 `config`） |
173
+ | `npx agy-powerline preset <name>` | プリセットを適用（一覧は `--list`） |
174
+ | `npx agy-powerline theme <name>` | テーマを切り替え（`--list`、`--gallery`） |
175
+ | `npx agy-powerline gradient <name>` | Color each row with a gradient (`--list`, `off`) |
176
+ | `npx agy-powerline layout <pills\|lines\|classic>` | レイアウトを切り替え |
177
+ | `npx agy-powerline caps <style>` | カプセルの形を切り替え：`round`、`angled`、`slanted`、`flat` |
178
+ | `npx agy-powerline export [file]` | Save your config to a file, to back it up or share it |
179
+ | `npx agy-powerline import <file>` | Load a config, after showing what changes (`--merge`) |
180
+ | `npx agy-powerline doctor` | インストールを確認し、問題を説明 |
181
+ | `npx agy-powerline report` | プライバシーに配慮したバグレポートを作成 |
182
+ | `npx agy-powerline uninstall [--delete]` | agy から削除（`--delete` でファイルも削除） |
183
+ | `npx agy-powerline render --demo` | サンプルデータでバーを表示 |
134
184
 
135
185
  各コマンドのオプションは `--help` で確認できます。
136
186
 
@@ -174,6 +224,7 @@ npx agy-powerline doctor # すべてが最新か確認
174
224
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/yuefdev"><img src="https://avatars.githubusercontent.com/u/120668197?v=4&s=160" width="80" height="80" alt="Yusuf Efe"/><br /><sub><b>Yusuf Efe</b></sub></a></td>
175
225
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/hiyouwhatsapp"><img src="https://avatars.githubusercontent.com/u/89997383?v=4&s=160" width="80" height="80" alt="hiyouwhatsapp"/><br /><sub><b>hiyouwhatsapp</b></sub></a></td>
176
226
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/dharamdan01"><img src="https://avatars.githubusercontent.com/u/188893946?v=4&s=160" width="80" height="80" alt="dharamdan01"/><br /><sub><b>dharamdan01</b></sub></a></td>
227
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/Ashuge11"><img src="https://avatars.githubusercontent.com/u/210247942?v=4&s=160" width="80" height="80" alt="Ashvini Sundge"/><br /><sub><b>Ashvini Sundge</b></sub></a></td>
177
228
  </tr>
178
229
  </tbody>
179
230
  </table>
@@ -185,6 +236,10 @@ npx agy-powerline doctor # すべてが最新か確認
185
236
 
186
237
  agy-powerline が役に立ったら、⭐ を付けていただけると他の agy ユーザーにも見つけてもらいやすくなります。
187
238
 
239
+ ## Star History
240
+
241
+ [![Star History Chart](https://api.star-history.com/svg?repos=wassim-azi/agy-powerline&type=Date)](https://star-history.com/#wassim-azi/agy-powerline&Date)
242
+
188
243
  ## ライセンス
189
244
 
190
245
  [MIT](LICENSE) © Wassim AZI