--- title: "atelier" url: "https://claudemods.dev/zh-tw/builds/atelier-f9658f" source: "https://github.com/mesix971/mods-claude/tree/main/atelier" source_type: "github" repo: "https://github.com/mesix971/mods-claude/tree/main/atelier" author: "mesix971" author_handle: "mesix971" stars: 0 category: "ๅ„€่กจๆฟ่ˆ‡ HUD" categories: ["hud"] tags: ["adb", "android", "guardrails", "hooks", "statusline"] permission_level: 3 scan_complete: true install: "claude plugin marketplace add mesix971/mods-claude\nclaude plugin install atelier@mods-claude" added: "2026-10-29T02:27:15.548Z" updated: "2026-10-29T02:27:15.548Z" locale: "zh-tw" content_locale: "en" --- # atelier A project band shown above the Claude Code prompt for Android developers, displaying app/APK/phone versions, git status, quota and context gauges, live turn cost, model advice and task pills, plus hooks that guard destructive shell commands and secret files. Unofficial fan-made mod, interface in French. ## Description atelier is a Claude Code mod that draws a band above the prompt for Android projects. It surfaces the declared app version, the last built APK and the version installed on the connected phone with Install and Launch buttons, a git line (branch, changes, ahead/behind) with Commit + push, Pull and Push buttons, gauges for the 5-hour and 7-day quotas and the context window, live turn cost in euros, Haiku-based model/effort advice, and pills for tasks, subagents and Gradle or Flutter builds. Its hooks add guardrails: confirmation dialogs before destructive commands (pm clear, uninstall, connectedAndroidTest, force push, reset --hard), before secret files such as local.properties, keystores, google-services.json or .env enter a commit or push, and before unrequested pushes. It refuses bash launched from PowerShell and long foreground waits, auto-detects adb and Android Studio's JBR, rewrites commands pointing at a broken JBR, and adds JAVA_HOME to gradlew when missing. It also submits fixed French git requests as user prompts and provides /tel and /atelier commands. Requires Claude Code 2.1.287 or later; MIT licensed with no network requests of its own, though it sends prompts to Haiku via Claude Code. ## Install ``` claude plugin marketplace add mesix971/mods-claude claude plugin install atelier@mods-claude ``` ## Original README # atelier A project band above the Claude Code prompt for Android developers, plus guardrails on shell commands. The interface is in French. Unofficial, fan-made project by mesix971. Not affiliated with or endorsed by Anthropic. ## The band - ๐Ÿ“ฑ The app version declared in the project (Gradle script, `pubspec.yaml` or `version.properties`), the last APK built and the version installed on the connected phone, with **Install** and **Launch** buttons. - ๐ŸŒฟ Git: branch, changes, commits ahead or behind, with **Commit + push**, **Pull** and **Push** buttons. - Gauges for the 5-hour and 7-day quotas and for the context window. On hover, each one projects when you will reach 100 % at the current pace. - The live cost of the turn at API prices, in euros. - Model advice: Claude Haiku reads each request you type and suggests a model and an effort level when they differ from what is running. - Claude's task list, its subagents and Gradle or Flutter builds, as small pills. - ๐Ÿ†• opens a new conversation. ## Guardrails - It asks before destructive commands (`pm clear`, `uninstall`, `connectedAndroidTest`, force push, `reset --hard`โ€ฆ). - It also asks before secrets (`local.properties`, keystores, `google-services.json`, `.env`) go into a commit or a push, and before a push you did not ask for. - It refuses `bash` launched from PowerShell, and foreground waits of 20 seconds or more. - It finds adb and Android Studio's JBR by itself. It rewrites a command that points to a broken JBR, and adds `JAVA_HOME` to `gradlew` when it is missing. - If Claude answers in English, it adds a short reminder to the next turn to answer in French. `/tel` installs the latest APK; `/atelier` shows or hides the band. ## Install ```bash claude plugin marketplace add mesix971/mods-claude claude plugin install atelier@mods-claude ``` Requires Claude Code 2.1.287 or later (mods). ## What it runs, sends and reads ### Programs it runs Only `git` and `adb`, each with fixed arguments: - `git status --porcelain=v1 -b`, `git remote`, and `git diff HEAD -U0` on the changed files, to draw the git line of the band. - Before a `git commit` or `git push` that Claude runs, `git ls-files` and `git diff --name-only`, to list the files it would send and warn you about secrets. - `adb devices -l`, then on the phone `date`, `pm list packages` and `dumpsys package`, to read the installed version. - `adb install -r` with the latest APK, only when you press **Install** or type `/tel`. - `adb shell monkey -p -c android.intent.category.LAUNCHER 1`, only when you press **Launch**. ### What it sends, and where - **To Claude Haiku, through Claude Code**: for the model advice, each request you type (its first and last 1,000 characters when it is longer than 2,000 characters). It also sends the project type, the number of open plan steps, whether the last build failed, the number of running subagents and whether your quota is tight. That is a few hundred tokens on your Claude account. Requests under 25 characters, slash commands, routines, other sessions, plugins and a hidden band send nothing. - **To Claude, as if you typed it**: the **Commit + push**, **Commit**, **Pull** and **Push** buttons each submit one fixed request, written in French. It asks Claude to commit, pull or push, then to check the result. Nothing from the conversation is added. Claude then runs git with its usual permissions, and push and pull talk to your git remote. - **Slash commands**: ๐Ÿ†• runs `/suite` when you have a command with that name. Otherwise it asks you first, then runs `/clear`. It makes no network request of its own. `www.w3.org` appears in its code only as the namespace of its SVG drawings. ### What its hooks change - **Bash and PowerShell commands**: it rewrites a command in two cases only. A path to a broken Android Studio JBR is replaced with the working one. A `gradlew` command gets `JAVA_HOME` set to that JBR when yours is missing or broken. - It refuses `bash` or `wsl` launched from PowerShell, and foreground waits of 20 seconds or more, and tells Claude why. - It asks you in a dialog before a destructive command, before secret files go into a commit or a push, and before a push you did not ask for. It never approves anything for you: a command it lets through still goes through Claude Code's own permission checks. - **Your prompts** go on unchanged, except after an answer in English. The next prompt then carries one line of context that asks Claude to answer in French. - **Subagent launches** go on unchanged. It only reads the new agent's type, task description, id and model, for its pill on the band. - `/tel` and `/atelier` are its own commands, and its own hooks answer them. ### What it reads - The project files that hold the app version (Gradle scripts, `pubspec.yaml`, `version.properties`, `gradle.properties`), the APK output folder, and the folders where adb and Android Studio's JBR usually live. - The environment variables `ANDROID_HOME`, `ANDROID_SDK_ROOT`, `JAVA_HOME`, `LOCALAPPDATA`, `HOME` and `USERPROFILE`, only to find adb and the JBR. - The quota, context and cost figures that Claude Code provides, and Claude's task list and subagents, for the band. It reads no token, password or key. Those words appear in its code only to mask secrets in the commands it shows on the band, and to spot secret files before a commit. It keeps its state in Claude Code's plugin state. ## License MIT. The "breathing" orb comes from [thinking-orbs](https://github.com/Jakubantalik/thinking-orbs) by Jakub Antalik (MIT); its notice is in `hooks/orbe.ts`.