agy-powerline 1.1.1 → 1.3.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 (41) hide show
  1. package/CHANGELOG.md +52 -0
  2. package/README.fr.md +190 -0
  3. package/README.ja.md +190 -0
  4. package/README.md +88 -30
  5. package/README.zh-CN.md +190 -0
  6. package/package.json +13 -4
  7. package/src/cli/caps.js +2 -0
  8. package/src/cli/configure.js +761 -66
  9. package/src/cli/doctor.js +12 -0
  10. package/src/cli/export.js +82 -0
  11. package/src/cli/gradient.js +121 -0
  12. package/src/cli/import.js +273 -0
  13. package/src/cli/init.js +186 -7
  14. package/src/cli/layout.js +2 -0
  15. package/src/cli/preset.js +2 -0
  16. package/src/cli/repo-url.js +7 -0
  17. package/src/cli/theme.js +2 -0
  18. package/src/cli/tui-style.js +154 -31
  19. package/src/cli/uninstall.js +6 -2
  20. package/src/index.js +51 -0
  21. package/src/lib/catalog.js +126 -5
  22. package/src/lib/colors.js +127 -0
  23. package/src/lib/config-check.js +74 -0
  24. package/src/lib/config.js +26 -2
  25. package/src/lib/exec.js +140 -21
  26. package/src/lib/fit.js +9 -0
  27. package/src/lib/formatters.js +67 -0
  28. package/src/lib/git.js +374 -2
  29. package/src/lib/layouts/lines.js +145 -20
  30. package/src/lib/layouts/pills.js +209 -18
  31. package/src/lib/mock-data.js +6 -1
  32. package/src/lib/paths.js +73 -13
  33. package/src/lib/prompt.js +30 -0
  34. package/src/lib/run.js +2 -0
  35. package/src/lib/session.js +61 -11
  36. package/src/lib/shared.js +11 -1
  37. package/src/lib/themes.js +79 -5
  38. package/src/lib/usage.js +524 -0
  39. package/src/lib/widget-options.js +194 -0
  40. package/src/lib/widget-style.js +41 -0
  41. package/src/runtime/statusline.js +15 -1
package/CHANGELOG.md CHANGED
@@ -5,6 +5,58 @@ 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]
9
+
10
+ ## [1.3.0] - 2026-10-18
11
+
12
+ ### Added
13
+
14
+ - `dark-macchiato` theme: Catppuccin Macchiato palette (#33, thanks @yatharth2soni)
15
+ - Gradients: `"gradient": "sunset"` (or `npx agy-powerline gradient sunset`) colors each row with one sweep from left to right, from eight presets or your own hex colors, with text kept readable and caution and danger colors kept as they are (#80)
16
+ - `exec` widgets can read the session JSON on stdin with `"payload": true` (your email and session IDs are removed first) and keep the colors their command prints with `"colors": true`; `docs/configuration.md` has recipes (#81)
17
+ - Git detail widgets, each opt-in: `gitChanges` (lines added and removed), `gitFiles` (staged, modified, untracked and conflicted files), `gitSha` (commit ID), `gitStash` (stash count) and `gitWorktree` (linked worktree name); with `gitFiles` on the bar, the `git` widget's dirty marker also counts uncommitted files (#82)
18
+ - `npx agy-powerline export [file]` and `npx agy-powerline import <file>` save and load your config: import shows what changes and previews the bar first, `--merge` changes only the settings in the file, new shell commands need their own confirmation or `--allow-exec`, and the previous config is kept as `statusline.config.json.bak` (#83)
19
+ - The README in French (`README.fr.md`) (#51, thanks @dharamdan01)
20
+ - Recipe: today's agy tokens from ccusage in the bar, with an `exec` widget (`docs/configuration.md` → Recipes) (#90)
21
+ - agy plugin: `agy plugin install https://github.com/wassim-azi/agy-powerline` adds an `agy-powerline-setup` skill that installs the bar from inside agy (`init`, then `doctor`) and an `agy-powerline-customize` skill that changes its theme, preset, layout, caps or gradient on request (#89)
22
+ - A first `init` in a terminal asks for a preset, a layout and a theme, with a preview of each; `--preset`, `--layout` and `--theme` answer them for scripted installs and change only those settings in an existing config (#91)
23
+ - `tokensToday` and `tokensWeek` widgets: tokens used today and over the last 7 days in all your agy conversations, read from agy's own local data (no network), with `"split"` and an optional `"budget"` that alerts like the context widgets; they need Node 22.13 or newer (#94)
24
+ - Meter styles: `"meterStyle": "blocks"` (or `"meter"` on one meter widget, also in `configure`) draws the quota and context meters as `blocks`, `shade`, `line`, `geometric`, `squares`, `braille`, `bars` or `dots` instead of each layout's own; ASCII mode keeps `#` and `-` (#93)
25
+ - The `git` widget shows a rebase (with its step, `REBASE 2/5`), `git am`, merge, cherry-pick, revert or bisect in progress, and the branch being rebased instead of a commit ID; `"operation": false` hides it (#92)
26
+ - Theme gallery online at https://agy-powerline.com/: every theme rendered by the real statusline code on dark and light terminals, with a color-blindness simulation (#110)
27
+ - Web configurator on GitHub Pages (https://agy-powerline.com/configure/): build your bar in the browser with live previews, themes, layouts, widget options, shareable URL links, and config export (#95)
28
+
29
+ ### Changed
30
+
31
+ - `init` ends with a link to the project page
32
+ - The Pages site (https://agy-powerline.com/) shares a header, footer, design tokens, SVG favicon, dark/light/system theme toggle, terminal window frames and 404 page across the theme gallery and web configurator, with a hero section and one-click theme links on the gallery (#114)
33
+
34
+ ### Fixed
35
+
36
+ - Exec widget intervals are always read in seconds; values of 1000 or more were read as milliseconds (#68, thanks @hiyouwhatsapp).
37
+ - The statusline exits quietly when Antigravity closes its output pipe (#45, thanks @dannyward630)
38
+ - `init` and `uninstall` keep a `settings.json` symlinked by a dotfile manager (stow, chezmoi, yadm) as a link and write the change into the file it points to; they used to replace the link with a plain file, so the real file never got the change. The same goes for a symlinked `statusline.config.json`
39
+ - A second `init` no longer loses your original `settings.json`: the first backup is now kept as `settings.json.agy-powerline.original.bak` and never replaced, next to the latest one
40
+ - `configure` describes the `git` widget fully: its list and details panel now mention the ahead/behind counts it shows, not only the branch and uncommitted changes
41
+
42
+ ## [1.2.0] - 2026-10-16
43
+
44
+ ### Added
45
+
46
+ - `configure` edits a widget's options: Enter on a widget sets its color, label, caution and danger levels, blink, pace marker, reset format, short model name or badge text, with the preview following each change (#29)
47
+ - The README in Simplified Chinese (`README.zh-CN.md`) and Japanese (`README.ja.md`), with a language switcher at the top of each README (#34)
48
+ - `argonWeekly` and `argonReset` widgets show Gemini 4 Argon's own weekly quota on Google AI Pro and when it resets, whatever model you're using; the `limits` preset gets them as a fourth row, which hides when there's no Argon quota (#38)
49
+
50
+ ### Changed
51
+
52
+ - `configure` fits your window: it fills the full width instead of stopping at 120 columns, lines descriptions up in a column, splits the width evenly between the list and a details panel from 140 columns (the selected widget drawn on its own with its options, a preset's rows, a theme's colors), scrolls long lists inside their panel in short windows instead of pushing the screen out of view, and redraws when the window is resized; it also gets a fresher look: a header with the GitHub star link and the navigation keys at the right end, the active tab and the selected item as rounded pills, widget icons in the lists, accent-colored panel titles, and details with headings, preset tags and color blocks (#29)
53
+ - `configure` is clearer about state: only widgets are numbered (flex spaces and new rows aren't), the preview title says when it shows a theme, preset or layout that isn't applied, the preset matching your widgets is marked `current` and lists its widgets with their icons, and a theme's details include a sample of the editor in that theme (#29)
54
+
55
+ ### Fixed
56
+
57
+ - The context widgets' token count matches the percentage next to it: it was input plus output tokens only, leaving out cached tokens (e.g. `5.3K/1.0M (11.7%)`), and is now the used share of the window (`123.1K/1.0M (11.7%)`) (#31)
58
+ - The tightest quota widget no longer shows Gemini 4 Argon's separate weekly quota (Google AI Pro) while another Gemini model is in use, under a cut-off name like `gemini-argon-wtu-wee`; it shows that quota as `Argon 7d` when Argon is the model in use (#37)
59
+
8
60
  ## [1.1.1] - 2026-10-12
9
61
 
10
62
  ### Changed
package/README.fr.md ADDED
@@ -0,0 +1,190 @@
1
+ # agy-powerline
2
+
3
+ [English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | **Français**
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
+ [![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é)
12
+ [![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)
13
+ [![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
+
15
+ > > **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.
16
+
17
+ **Une barre d’état rapide et configurable pour la CLI de Google Antigravity (`agy`).**
18
+
19
+ 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
+
21
+ <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">
23
+ </p>
24
+
25
+ ## Installation
26
+
27
+ Vous avez besoin de [Node.js](https://nodejs.org/) 20 ou d’une version ultérieure, ainsi que de l’[interface en ligne de commande Antigravity](https://antigravity.google/docs/cli/overview). Compatible avec Windows, macOS, Linux et WSL ([remarques sur WSL](docs/install.md#wsl)).
28
+
29
+ ```bash
30
+ npx agy-powerline init # install the statusline into agy
31
+ npx agy-powerline configure # optional: pick widgets, theme and layout
32
+ agy # start Antigravity
33
+ ```
34
+
35
+ 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
+
37
+ Vous pouvez aussi laisser agy effectuer l’installation : collez cette instruction dans une session `agy`.
38
+
39
+ ```text
40
+ Install the agy-powerline statusline: run `npx agy-powerline init --yes`, then tell me to restart agy.
41
+ ```
42
+
43
+ L’option `--yes` évite les questions auxquelles agy ne peut pas répondre et remplace toute configuration `statusLine` existante, après sauvegarde de `settings.json`.
44
+
45
+ Pour un terminal sans police Nerd Font, activez le mode ASCII (touche `i` dans `configure`).
46
+
47
+ ## Personnalisation
48
+
49
+ `npx agy-powerline configure` ouvre un éditeur qui affiche un aperçu en temps réel de votre barre d’état. Utilisez `←` et `→` pour passer d’un onglet à l’autre (Widgets, Presets, Themes, Layout, Powerline) ; `↑` et `↓` pour vous déplacer ; Entrée pour sélectionner ; et `q` pour enregistrer et quitter. Les touches disponibles sont affichées en bas de chaque écran. La liste complète figure dans la [documentation de configuration](docs/configuration.md#configurator-keys).
50
+
51
+ Les modifications s’appliquent à une session `agy` en cours lors de l’actualisation suivante.
52
+
53
+ ### Préréglages
54
+
55
+ Choisissez un préréglage comme point de départ, puis personnalisez-le :
56
+
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 |
64
+
65
+ ### Thèmes
66
+
67
+ | Fond du terminal | Thèmes |
68
+ | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
69
+ | Sombre | `dark-aurora` (par défaut), `dark-ocean`, `dark-ember`, `dark-forest`, `dark-neon`, `dark-mono`, `dark-nocturne`, `dark-onyx`, `dark-metro`, `dark-macchiato` |
70
+ | Clair | `light-paper`, `light-sky`, `light-sunset`, `light-cream` |
71
+ | Adapté au daltonisme | `colorblind-dark`, `colorblind-light` |
72
+ | Couleurs personnalisées | `custom` ([mode d’emploi](docs/configuration.md#custom-theme)) |
73
+
74
+ Prévisualisez tous les thèmes avec `npx agy-powerline theme --gallery`.
75
+
76
+ ### Dispositions
77
+
78
+ **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
+
80
+ <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">
82
+ </p>
83
+
84
+ **Lines** : les mêmes informations sous forme de texte coloré classique.
85
+
86
+ <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">
89
+ </p>
90
+
91
+ ## Widgets
92
+
93
+ | Widget | Informations affichées |
94
+ | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
95
+ | `model` | Modèle utilisé |
96
+ | `fiveHourBar`, `weeklyBar` | Quota restant sur 5h/7d sous forme de jauge, avec un [indicateur de rythme](docs/configuration.md#quota-pace-marker) |
97
+ | `fiveHourPct`, `weeklyPct` | Pourcentage de quota restant sur 5h/7d |
98
+ | `fiveHourReset`, `weeklyReset` | Temps restant avant la réinitialisation du quota, ou heure de réinitialisation |
99
+ | `quota` | Quota le plus proche de sa limite, avec son heure de réinitialisation |
100
+ | `thirdPartyFiveHour`, `thirdPartyWeekly` | Quotas des modèles tiers |
101
+ | `argonWeekly`, `argonReset` | Quota hebdomadaire propre à Gemini 4 Argon (Google AI Pro) et sa réinitialisation |
102
+ | `context`, `contextPct`, `contextTokens` | Fenêtre de contexte utilisée : jauge, pourcentage ou nombre de tokens |
103
+ | `git` | Branche, modifications non validées et commits en avance ou en retard |
104
+ | `gitChanges`, `gitFiles`, `gitSha`, `gitStash`, `gitWorktree` | Lines added and removed, staged/modified/untracked/conflicted files, commit ID, stashes, linked worktree |
105
+ | `project`, `cwd` | Dossier du projet et dossier courant |
106
+ | `agentState`, `plan`, `sandbox`, `artifacts`, `version` | Activité de l’agent, abonnement Antigravity, bac à sable, artefacts et version de la CLI |
107
+ | `tasks` | Sous-agents actifs et tâches en arrière-plan |
108
+ | `mode` | Mode d’approbation (par exemple `accept-edits`) et mode Vim |
109
+ | `title` | Titre de la conversation |
110
+ | `totalTokens`, `cacheHit`, `cacheRead`, `cacheCreate` | Tokens de la session et utilisation du cache des prompts |
111
+ | `tokensToday`, `tokensWeek` | Tokens utilisés aujourd’hui et sur les 7 derniers jours, toutes conversations confondues (Node 22.13+) |
112
+ | `ram` | Mémoire utilisée sur votre machine |
113
+ | `customText`, `exec` | Texte personnalisé ou résultat d’une [commande shell](docs/configuration.md#shell-command-widget-exec) |
114
+
115
+ 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
+
117
+ ## Commandes
118
+
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 |
134
+
135
+ Utilisez l’option `--help` avec n’importe quelle commande pour afficher les options disponibles.
136
+
137
+ ## Mise à jour
138
+
139
+ ```bash
140
+ npx agy-powerline init --yes # install the new version's scripts
141
+ npx agy-powerline doctor # check everything is up to date
142
+ ```
143
+
144
+ Vos paramètres sont conservés. Redémarrez ensuite `agy`.
145
+
146
+ ## Dépannage
147
+
148
+ Commencez par exécuter `npx agy-powerline doctor` : cette commande vérifie l’installation et explique comment corriger les problèmes détectés. Retrouvez les problèmes courants et la procédure pour signaler un bogue dans le [guide de dépannage](docs/troubleshooting.md).
149
+
150
+ ## Confidentialité et sécurité
151
+
152
+ - **Aucun appel réseau, aucune télémétrie.** Toutes les informations proviennent des données transmises par agy à la barre d’état, de `.git` et de votre système d’exploitation. Le seul lien externe est accessible avec la touche `g` dans `configure`, qui ouvre la page GitHub dans votre navigateur.
153
+ - **Vos paramètres sont protégés.** `init` et `uninstall` sauvegardent `settings.json` et refusent de modifier un fichier qu’ils ne parviennent pas à analyser.
154
+ - **Rien ne s’exécute sans que vous l’ayez ajouté.** À l’exception d’une brève commande `git` pour compter les commits en avance ou en retard, les seules commandes exécutées par la barre sont celles des widgets `exec` que vous configurez vous-même.
155
+ - **Aucune dépendance à l’exécution**, avec une publication depuis la CI et une [attestation de provenance npm](https://docs.npmjs.com/generating-provenance-statements).
156
+
157
+ Pour plus de détails, consultez [SECURITY.md](SECURITY.md).
158
+
159
+ ## Contribution
160
+
161
+ Les contributions sont les bienvenues. Commencez par lire [CONTRIBUTING.md](CONTRIBUTING.md) (installation de l’environnement de développement, architecture, ajout d’un widget ou d’un thème) et le [Code de conduite](CODE_OF_CONDUCT.md). Ouvrez vos pull requests vers la branche `develop`. Signalez les bogues dans les [issues GitHub](https://github.com/wassim-azi/agy-powerline/issues) ou partagez vos idées et commentaires dans les [discussions](https://github.com/wassim-azi/agy-powerline/discussions).
162
+
163
+ Merci à toutes les personnes ayant contribué au projet :
164
+
165
+ <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
166
+ <!-- prettier-ignore-start -->
167
+ <!-- markdownlint-disable -->
168
+ <table>
169
+ <tbody>
170
+ <tr>
171
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/yatharth2soni"><img src="https://avatars.githubusercontent.com/u/238868599?v=4&s=160" width="80" height="80" alt="Yatharth Soni"/><br /><sub><b>Yatharth Soni</b></sub></a></td>
172
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/dannyward630"><img src="https://avatars.githubusercontent.com/u/71604164?v=4&s=160" width="80" height="80" alt="Danny Ward"/><br /><sub><b>Danny Ward</b></sub></a></td>
173
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/yoreva-01"><img src="https://avatars.githubusercontent.com/u/195282707?v=4&s=160" width="80" height="80" alt="Yusuf Orçan"/><br /><sub><b>Yusuf Orçan</b></sub></a></td>
174
+ <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
+ <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
+ <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>
177
+ </tr>
178
+ </tbody>
179
+ </table>
180
+
181
+ <!-- markdownlint-restore -->
182
+ <!-- prettier-ignore-end -->
183
+
184
+ <!-- ALL-CONTRIBUTORS-LIST:END -->
185
+
186
+ Si agy-powerline vous est utile, une ⭐ permet à d’autres utilisateurs d’agy de le découvrir.
187
+
188
+ ## Licence
189
+
190
+ [MIT](LICENSE) © Wassim AZI
package/README.ja.md ADDED
@@ -0,0 +1,190 @@
1
+ # agy-powerline
2
+
3
+ [English](README.md) | [简体中文](README.zh-CN.md) | **日本語** | [Français](README.fr.md)
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
+ [![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)](#プライバシーとセキュリティ)
12
+ [![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)
13
+ [![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
+
15
+ > この文書は英語版 [README](README.md) の翻訳で、最新の内容に追いついていない場合があります。内容が異なる場合は英語版が優先されます。詳しいドキュメント（[`docs/`](docs/)）は英語版のみです。
16
+
17
+ **Google Antigravity の CLI（`agy`）向けの、高速でカスタマイズ可能なステータスライン。**
18
+
19
+ 使用中のモデル、Gemini の 5h/7d・Claude/GPT・Argon のクォータ、コンテキストウィンドウ、git ブランチなどがひと目でわかります。ウィジェット、テーマ、レイアウトは対話式のエディターで選べます。インストールはコマンドひとつ、依存パッケージはありません。
20
+
21
+ <p align="center">
22
+ <img src="assets/screenshots/pills-dark.png" alt="dark-ocean テーマの agy-powerline Pills レイアウト：エージェントの状態、モデル、プラン、プロジェクト、git；コンテキスト；5h と 7d のクォータとリセットまでの時間" width="850">
23
+ </p>
24
+
25
+ ## インストール
26
+
27
+ [Node.js](https://nodejs.org/) 20 以上と [Antigravity CLI](https://antigravity.google/docs/cli/overview) が必要です。Windows、macOS、Linux、WSL で動作します（[WSL についての注意](docs/install.md#wsl)）。
28
+
29
+ ```bash
30
+ npx agy-powerline init # agy にステータスラインをインストール
31
+ npx agy-powerline configure # 任意：ウィジェット、テーマ、レイアウトを選ぶ
32
+ agy # Antigravity を起動
33
+ ```
34
+
35
+ `init` は何かを置き換える前に確認し、先に Antigravity の `settings.json` をバックアップします。`init` の後に `agy` を一度再起動してください。詳細：[`init` が行うこと](docs/install.md)。
36
+
37
+ agy にインストールしてもらうこともできます。次の文を `agy` のセッションに貼り付けてください。
38
+
39
+ ```text
40
+ Install the agy-powerline statusline: run `npx agy-powerline init --yes`, then tell me to restart agy.
41
+ ```
42
+
43
+ `--yes` は agy が答えられない確認をスキップし、`settings.json` をバックアップしたうえで既存の `statusLine` を置き換えます。
44
+
45
+ Nerd Font のないターミナルでは、ASCII モードをオンにしてください（`configure` で `i`）。
46
+
47
+ ## カスタマイズ
48
+
49
+ `npx agy-powerline configure` を実行すると、バーのライブプレビュー付きのエディターが開きます。`←` `→` で Widgets、Presets、Themes、Layout、Powerline を切り替え、`↑` `↓` で移動、Enter で選択、`q` で保存して終了します。各画面のキーは画面下部に表示されます。キーの一覧は [Configuration](docs/configuration.md#configurator-keys) にあります。
50
+
51
+ 変更は、実行中の `agy` の次回の更新時に反映されます。
52
+
53
+ ### プリセット
54
+
55
+ プリセットから始めて、好みに合わせて調整します：
56
+
57
+ | プリセット | 表示内容 |
58
+ | ----------- | --------------------------------------------------------------------------------------------- |
59
+ | `default` | モデル、コンテキスト、git；2 行目に 5h と 7d のクォータとリセットまでの時間 |
60
+ | `compact` | 1 行：短いモデル名、最も残りの少ないクォータ、コンテキスト %、git |
61
+ | `workspace` | プロジェクト、git、エージェントの状態、モデル；コンテキスト、最も残りの少ないクォータ、モード |
62
+ | `limits` | すべてのクォータ（5h、7d、サードパーティ、Argon）を 1 行にひとつずつ |
63
+ | `full` | すべて：セッション、プロジェクト、git；コンテキスト、トークン、キャッシュ；両方のクォータ |
64
+
65
+ ### テーマ
66
+
67
+ | ターミナルの背景 | テーマ |
68
+ | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
69
+ | ダーク | `dark-aurora`（デフォルト）、`dark-ocean`、`dark-ember`、`dark-forest`、`dark-neon`、`dark-mono`、`dark-nocturne`、`dark-onyx`、`dark-metro`、`dark-macchiato` |
70
+ | ライト | `light-paper`、`light-sky`、`light-sunset`、`light-cream` |
71
+ | 色覚多様性に配慮 | `colorblind-dark`、`colorblind-light` |
72
+ | 独自の配色 | `custom`（[方法](docs/configuration.md#custom-theme)） |
73
+
74
+ すべてのテーマは `npx agy-powerline theme --gallery` でプレビューできます。
75
+
76
+ ### レイアウト
77
+
78
+ **Pills**（デフォルト）：powerline 風のカプセル。形は丸型、山型、斜め、フラットから選べ、行の間に空行を入れることもできます。
79
+
80
+ <p align="center">
81
+ <img src="assets/screenshots/pills-light.png" alt="明るいターミナルでの light-sky テーマの agy-powerline Pills レイアウト、行間あり" width="850">
82
+ </p>
83
+
84
+ **Lines**：同じ情報を色付きのプレーンテキストで表示します。
85
+
86
+ <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">
89
+ </p>
90
+
91
+ ## ウィジェット
92
+
93
+ | ウィジェット | 表示内容 |
94
+ | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
95
+ | `model` | 使用中のモデル |
96
+ | `fiveHourBar`、`weeklyBar` | 5h / 7d クォータの残りをメーターで表示（[ペースマーカー](docs/configuration.md#quota-pace-marker)付き） |
97
+ | `fiveHourPct`、`weeklyPct` | 5h / 7d クォータの残りをパーセントで表示 |
98
+ | `fiveHourReset`、`weeklyReset` | クォータがリセットされるまでの時間、またはリセット時刻 |
99
+ | `quota` | 最も早く尽きそうなクォータとそのリセット |
100
+ | `thirdPartyFiveHour`、`thirdPartyWeekly` | サードパーティモデルのクォータ |
101
+ | `argonWeekly`、`argonReset` | Gemini 4 Argon 専用の週間クォータ（Google AI Pro）とそのリセット |
102
+ | `context`、`contextPct`、`contextTokens` | 使用中のコンテキストウィンドウ：メーター、パーセント、またはトークン数 |
103
+ | `git` | ブランチ、未コミットの変更、ahead/behind |
104
+ | `gitChanges`, `gitFiles`, `gitSha`, `gitStash`, `gitWorktree` | Lines added and removed, staged/modified/untracked/conflicted files, commit ID, stashes, linked worktree |
105
+ | `project`、`cwd` | プロジェクトのフォルダー、現在のフォルダー |
106
+ | `agentState`、`plan`、`sandbox`、`artifacts`、`version` | エージェントの動作状況、プラン、サンドボックス、アーティファクト、CLI のバージョン |
107
+ | `tasks` | 実行中のサブエージェントとバックグラウンドタスク |
108
+ | `mode` | 承認モード（例：accept-edits）と Vim モード |
109
+ | `title` | 会話のタイトル |
110
+ | `totalTokens`、`cacheHit`、`cacheRead`、`cacheCreate` | セッションのトークン数とプロンプトキャッシュの使用状況 |
111
+ | `tokensToday`、`tokensWeek` | 今日と過去 7 日間のトークン使用量（すべての会話、Node 22.13 以降） |
112
+ | `ram` | マシンのメモリ使用量 |
113
+ | `customText`、`exec` | 任意のテキスト、または [シェルコマンド](docs/configuration.md#shell-command-widget-exec)の出力 |
114
+
115
+ 表示する内容のないウィジェットは自動的に隠れます。ウィジェットごとに色を変えたり、ラベルを外したり、独自の警告しきい値を設定したりできます。詳しくは [Configuration](docs/configuration.md) を参照してください。
116
+
117
+ ## コマンド
118
+
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` | サンプルデータでバーを表示 |
134
+
135
+ 各コマンドのオプションは `--help` で確認できます。
136
+
137
+ ## 更新
138
+
139
+ ```bash
140
+ npx agy-powerline init --yes # 新しいバージョンのスクリプトをインストール
141
+ npx agy-powerline doctor # すべてが最新か確認
142
+ ```
143
+
144
+ 設定はそのまま残ります。更新後に `agy` を再起動してください。
145
+
146
+ ## トラブルシューティング
147
+
148
+ まず `npx agy-powerline doctor` を実行してください。インストールを確認し、見つかった問題の直し方を教えてくれます。よくある問題とバグの報告方法：[Troubleshooting](docs/troubleshooting.md)。
149
+
150
+ ## プライバシーとセキュリティ
151
+
152
+ - **ネットワーク通信なし、テレメトリなし。** 表示する情報はすべて、agy がバーに渡すデータ、`.git`、OS から取得します。外部へのリンクは `configure` の `g` だけで、ブラウザーで GitHub のページを開きます。
153
+ - **設定は安全です。** `init` と `uninstall` は `settings.json` をバックアップし、解析できないファイルは編集しません。
154
+ - **追加しない限り何も実行されません。** ahead/behind を数えるための短い `git` の呼び出しを除き、バーが実行するコマンドは自分で設定した `exec` ウィジェットだけです。
155
+ - **ランタイム依存パッケージはゼロ**で、CI から [npm provenance](https://docs.npmjs.com/generating-provenance-statements) 付きで公開されています。
156
+
157
+ 詳細：[SECURITY.md](SECURITY.md)。
158
+
159
+ ## コントリビュート
160
+
161
+ コントリビュートを歓迎します。まず [CONTRIBUTING.md](CONTRIBUTING.md)（セットアップ、アーキテクチャ、ウィジェットやテーマの追加）と [Code of Conduct](CODE_OF_CONDUCT.md) をお読みください。プルリクエストは `develop` に向けて作成してください。バグは [GitHub issues](https://github.com/wassim-azi/agy-powerline/issues) で報告し、アイデアやフィードバックは [Discussions](https://github.com/wassim-azi/agy-powerline/discussions) で共有してください。
162
+
163
+ コントリビューターの皆さんに感謝します：
164
+
165
+ <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
166
+ <!-- prettier-ignore-start -->
167
+ <!-- markdownlint-disable -->
168
+ <table>
169
+ <tbody>
170
+ <tr>
171
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/yatharth2soni"><img src="https://avatars.githubusercontent.com/u/238868599?v=4&s=160" width="80" height="80" alt="Yatharth Soni"/><br /><sub><b>Yatharth Soni</b></sub></a></td>
172
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/dannyward630"><img src="https://avatars.githubusercontent.com/u/71604164?v=4&s=160" width="80" height="80" alt="Danny Ward"/><br /><sub><b>Danny Ward</b></sub></a></td>
173
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/yoreva-01"><img src="https://avatars.githubusercontent.com/u/195282707?v=4&s=160" width="80" height="80" alt="Yusuf Orçan"/><br /><sub><b>Yusuf Orçan</b></sub></a></td>
174
+ <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
+ <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
+ <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>
177
+ </tr>
178
+ </tbody>
179
+ </table>
180
+
181
+ <!-- markdownlint-restore -->
182
+ <!-- prettier-ignore-end -->
183
+
184
+ <!-- ALL-CONTRIBUTORS-LIST:END -->
185
+
186
+ agy-powerline が役に立ったら、⭐ を付けていただけると他の agy ユーザーにも見つけてもらいやすくなります。
187
+
188
+ ## ライセンス
189
+
190
+ [MIT](LICENSE) © Wassim AZI