craftkit 0.3.0__tar.gz → 0.3.1__tar.gz

{craftkit-0.3.0/craftkit.egg-info → craftkit-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: craftkit
-Version: 0.3.0
+Version: 0.3.1
 Summary: Study → build → check → refine any software, from the terminal, with your coding agent.
 License-Expression: MIT OR Apache-2.0
 Keywords: cli,coding-agent,claude-code,codex,gemini,rebuild,skill
@@ -23,7 +23,7 @@ Dynamic: license-file
 > **In English:** `craft` rebuilds any software (website, CLI, app, game, library) with the coding
 > agent you already use (Claude Code, Codex, Gemini CLI): it studies the original, briefs the agent,
 > checks the result against the original and sends it back until it holds. Install with
-> `npm install -g craftkit` or `pipx install craftkit`, then type `craft`.
+> `npm install -g craftkit-cli` or `pipx install craftkit`, then type `craft`.
 
 La méthode de Craft Anything, réduite à l'essentiel : **étudier → construire → vérifier → affiner**,
 pour recréer ou construire n'importe quel logiciel (site web, outil en ligne de commande, application,
@@ -66,16 +66,16 @@ construction bleu, affinage violet, vérification ambre, prêt vert.
 Gratuit, au choix :
 
 ```sh
-npm install -g craftkit        # avec Node ; il faut aussi Python 3.9+ sur la machine
-pipx install craftkit          # ou : uv tool install craftkit
+npm install -g craftkit-cli   # avec Node ; il faut aussi Python 3.9+ sur la machine
+pipx install craftkit             # ou : uv tool install craftkit
 ```
 
-Pour l'essayer sans rien installer : `npx craftkit` ou `uvx craftkit`.
+Pour l'essayer sans rien installer : `npx craftkit-cli` ou `uvx craftkit`.
 Ensuite, le skill pour Claude Code (tous les projets) : `craft skill --install ~/.claude/skills`.
 
 Les deux paquets contiennent exactement le même programme Python (aucune dépendance) ; celui de npm
 le lance avec le Python de la machine (`CRAFT_PYTHON=/chemin/vers/python3` pour en choisir un).
-Mise à jour : `npm update -g craftkit`, `pipx upgrade craftkit` ou `uv tool upgrade craftkit`.
+Mise à jour : `npm update -g craftkit-cli`, `pipx upgrade craftkit` ou `uv tool upgrade craftkit`.
 
 Depuis les sources : `pipx install .` dans ce dossier, ou `python3 -m craft_kit …` sans installer.
 
@@ -122,6 +122,7 @@ craft open                                  # ouvrir le résultat
 | `craft status` | où en est le projet |
 | `craft answer` | répondre aux questions de l'agent |
 | `craft brief` | afficher la tâche, pour la coller dans n'importe quel agent |
+| `craft agents` | les agents de code installés, et comment en installer un |
 | `craft skill [--install DOSSIER]` | afficher ou installer le SKILL.md |
 
 Options de `new` : `--kind website|cli|app|game|tool`, `--stack rust|python|react|html|…`,
@@ -149,6 +150,19 @@ propres outils.
 
 ## Agents
 
+`craft` n'écrit pas le code lui-même : il faut un agent de code sur la machine. Sans agent, `craft`
+le dit dès l'écran d'accueil, à `craft new` et au début de `craft run` (avant l'étude), avec les
+commandes exactes ; `craft agents` montre ce qui est trouvé :
+
+| Agent | Installer | Puis, une fois |
+|-------|-----------|----------------|
+| Claude Code | `npm install -g @anthropic-ai/claude-code` (ou `curl -fsSL https://claude.ai/install.sh \| bash`) | lancer `claude` et se connecter |
+| Codex | `npm install -g @openai/codex` | lancer `codex` et se connecter |
+| Gemini CLI | `npm install -g @google/gemini-cli` (ou `brew install gemini-cli`) | lancer `gemini` et se connecter (offre gratuite avec un compte Google) |
+
+Sans agent du tout : `craft brief` affiche la tâche, à coller dans n'importe quel assistant de code
+(Cursor, Copilot…) ouvert dans le dossier du projet, puis `craft check`.
+
 Ordre par défaut : `claude`, `codex`, `gemini` (le premier installé). Choisir : `--agent codex` ou
 `CRAFT_AGENT=codex`. La tâche est envoyée sur l'entrée standard (jamais en argument : elle peut être
 longue). Ajouter ou modifier un agent dans `~/.config/craft/agents.json` :

{craftkit-0.3.0 → craftkit-0.3.1}/README.md

@@ -3,7 +3,7 @@
 > **In English:** `craft` rebuilds any software (website, CLI, app, game, library) with the coding
 > agent you already use (Claude Code, Codex, Gemini CLI): it studies the original, briefs the agent,
 > checks the result against the original and sends it back until it holds. Install with
-> `npm install -g craftkit` or `pipx install craftkit`, then type `craft`.
+> `npm install -g craftkit-cli` or `pipx install craftkit`, then type `craft`.
 
 La méthode de Craft Anything, réduite à l'essentiel : **étudier → construire → vérifier → affiner**,
 pour recréer ou construire n'importe quel logiciel (site web, outil en ligne de commande, application,
@@ -46,16 +46,16 @@ construction bleu, affinage violet, vérification ambre, prêt vert.
 Gratuit, au choix :
 
 ```sh
-npm install -g craftkit        # avec Node ; il faut aussi Python 3.9+ sur la machine
-pipx install craftkit          # ou : uv tool install craftkit
+npm install -g craftkit-cli   # avec Node ; il faut aussi Python 3.9+ sur la machine
+pipx install craftkit             # ou : uv tool install craftkit
 ```
 
-Pour l'essayer sans rien installer : `npx craftkit` ou `uvx craftkit`.
+Pour l'essayer sans rien installer : `npx craftkit-cli` ou `uvx craftkit`.
 Ensuite, le skill pour Claude Code (tous les projets) : `craft skill --install ~/.claude/skills`.
 
 Les deux paquets contiennent exactement le même programme Python (aucune dépendance) ; celui de npm
 le lance avec le Python de la machine (`CRAFT_PYTHON=/chemin/vers/python3` pour en choisir un).
-Mise à jour : `npm update -g craftkit`, `pipx upgrade craftkit` ou `uv tool upgrade craftkit`.
+Mise à jour : `npm update -g craftkit-cli`, `pipx upgrade craftkit` ou `uv tool upgrade craftkit`.
 
 Depuis les sources : `pipx install .` dans ce dossier, ou `python3 -m craft_kit …` sans installer.
 
@@ -102,6 +102,7 @@ craft open                                  # ouvrir le résultat
 | `craft status` | où en est le projet |
 | `craft answer` | répondre aux questions de l'agent |
 | `craft brief` | afficher la tâche, pour la coller dans n'importe quel agent |
+| `craft agents` | les agents de code installés, et comment en installer un |
 | `craft skill [--install DOSSIER]` | afficher ou installer le SKILL.md |
 
 Options de `new` : `--kind website|cli|app|game|tool`, `--stack rust|python|react|html|…`,
@@ -129,6 +130,19 @@ propres outils.
 
 ## Agents
 
+`craft` n'écrit pas le code lui-même : il faut un agent de code sur la machine. Sans agent, `craft`
+le dit dès l'écran d'accueil, à `craft new` et au début de `craft run` (avant l'étude), avec les
+commandes exactes ; `craft agents` montre ce qui est trouvé :
+
+| Agent | Installer | Puis, une fois |
+|-------|-----------|----------------|
+| Claude Code | `npm install -g @anthropic-ai/claude-code` (ou `curl -fsSL https://claude.ai/install.sh \| bash`) | lancer `claude` et se connecter |
+| Codex | `npm install -g @openai/codex` | lancer `codex` et se connecter |
+| Gemini CLI | `npm install -g @google/gemini-cli` (ou `brew install gemini-cli`) | lancer `gemini` et se connecter (offre gratuite avec un compte Google) |
+
+Sans agent du tout : `craft brief` affiche la tâche, à coller dans n'importe quel assistant de code
+(Cursor, Copilot…) ouvert dans le dossier du projet, puis `craft check`.
+
 Ordre par défaut : `claude`, `codex`, `gemini` (le premier installé). Choisir : `--agent codex` ou
 `CRAFT_AGENT=codex`. La tâche est envoyée sur l'entrée standard (jamais en argument : elle peut être
 longue). Ajouter ou modifier un agent dans `~/.config/craft/agents.json` :

{craftkit-0.3.0 → craftkit-0.3.1}/craft_kit/__init__.py

@@ -1,3 +1,3 @@
 """craft-kit: study → build → check → refine any software, from the terminal."""
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"

{craftkit-0.3.0 → craftkit-0.3.1}/craft_kit/agent.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 
 import json
 import os
+import sys
 from typing import Optional
 
 from . import proc, tables
@@ -15,19 +16,74 @@ TURN_TIMEOUT = float(os.environ.get("CRAFT_TURN_TIMEOUT", 3 * 3600))
 IDLE_TIMEOUT = float(os.environ.get("CRAFT_IDLE_TIMEOUT", 20 * 60))
 
 
-def pick(name: Optional[str]) -> tuple[str, dict]:
+def installed(table: Optional[dict] = None) -> list[str]:
+    """The agents whose program is on this computer, in order of preference."""
+    table = table or tables.agents()
+    return [n for n in tables.AGENT_ORDER if n in table and proc.which(table[n]["argv"][0])]
+
+
+def guide(ui: UI, names: Optional[list] = None) -> None:
+    """How to install and sign in to a coding agent, with the exact commands."""
+    table = tables.agents()
+    names = [n for n in (names or tables.AGENT_ORDER) if n in table]
+    platform = sys.platform if sys.platform in ("darwin", "win32") else "linux"
+    ui.say("")
+    ui.say(f"   craft doesn't write code itself: a coding agent does. {'Install it' if len(names) == 1 else 'Install one of these'}, then sign in once:")
+    ui.say("")
+    width = max([len(table[n].get("title", n)) for n in names] + [8]) + 3
+    for n in names:
+        spec = table[n]
+        title = spec.get("title", n)
+        install = spec.get("install") or f"install `{spec['argv'][0]}` and put it on your PATH"
+        ui.say(f"   {ui.bold(f'{title:<{width}}')}{install}")
+        alt = (spec.get("alt") or {}).get(platform)
+        if alt:
+            ui.say(f"   {' ' * width}{ui.dim('or:')} {alt}")
+        if spec.get("login"):
+            ui.say(f"   {' ' * width}{ui.dim('then ' + spec['login'])}")
+    if not proc.which("npm"):
+        ui.say("")
+        ui.say(f"   {ui.yellow('npm')} isn't on this computer: it comes with Node.js ({tables.NODE_URL}).")
+    ui.say("")
+    ui.say(f"   {ui.dim('Then:')} craft run   {ui.dim('· see what is found:')} craft agents")
+    ui.say(f"   {ui.dim('No agent here? craft brief prints the task: paste it into any coding assistant')}")
+    ui.say(f"   {ui.dim('(Cursor, Copilot, …) opened in the project folder, then run')} craft check{ui.dim('.')}")
+
+
+def no_agent() -> CraftError:
+    return CraftError("No coding agent found on this computer (Claude Code, Codex or Gemini CLI).", guide=guide)
+
+
+def resolve(remembered: Optional[str], asked: Optional[str]) -> tuple[str, dict, Optional[str]]:
+    """The agent for a project: (name, spec, the remembered agent that's gone, if any). Raises a
+    CraftError with install steps when none can run."""
+    if not asked and not os.environ.get("CRAFT_AGENT") and remembered and remembered not in installed():
+        name, spec = pick(None)
+        return name, spec, remembered
+    name, spec = pick(asked or remembered)
+    return name, spec, None
+
+
+def pick(name: Optional[str], strict: bool = True) -> tuple[str, dict]:
+    """The agent to use. An agent asked for by name must be installed; one only remembered from an
+    earlier run gives way to another installed agent."""
     table = tables.agents()
-    name = name or os.environ.get("CRAFT_AGENT")
-    if name:
-        if name == "none":
+    explicit = name or os.environ.get("CRAFT_AGENT")
+    if explicit:
+        if explicit == "none":
             raise CraftError("No agent: the brief is in BRIEF.md.", "Paste BRIEF.md into any coding agent opened in this folder, then run `craft check`.")
-        if name not in table:
-            raise CraftError(f"Unknown agent “{name}”.", f"Known: {', '.join(table)}. Add one in {tables.config_dir() / 'agents.json'}.")
-        return name, table[name]
-    for n in tables.AGENT_ORDER:
-        if n in table and proc.which(table[n]["argv"][0]):
-            return n, table[n]
-    raise CraftError("No coding agent found (claude, codex or gemini).", "Install one, or use `craft brief` and paste it into the agent you use, then `craft check`.")
+        if explicit not in table:
+            raise CraftError(f"Unknown agent “{explicit}”.", f"Known: {', '.join(table)}. Add one in {tables.config_dir() / 'agents.json'}.")
+        if proc.which(table[explicit]["argv"][0]) or not strict:
+            return explicit, table[explicit]
+        title = table[explicit].get("title", explicit)
+        others = [n for n in installed(table) if n != explicit]
+        hint = f" ({', '.join(others)} is installed: craft run --agent {others[0]})" if others else ""
+        raise CraftError(f"{title} isn't installed, or isn't on your PATH{hint}.", guide=lambda ui: guide(ui, [explicit]))
+    found = installed(table)
+    if found:
+        return found[0], table[found[0]]
+    raise no_agent()
 
 
 TOOL_KINDS = {
@@ -122,7 +178,10 @@ def _describe_tool(name: str, args: dict, root: str = "") -> str:
 
 
 def turn(p: Project, message: str, ui: UI, agent: Optional[str], label: str) -> str:
-    name, spec = pick(agent or p.state.get("agent"))
+    name, spec, gone = resolve(p.state.get("agent"), agent)
+    if gone:
+        ui.note(f"{gone} isn't on this computer any more; using {name}.")
+        p.state["session"] = None
     p.state["agent"] = name
     p.state["turns"] = p.state.get("turns", 0) + 1
     rd = p.root / "checks" / f"turn-{p.state['turns']}"
@@ -159,7 +218,8 @@ def turn(p: Project, message: str, ui: UI, agent: Optional[str], label: str) ->
     p.save()
     if not r.ok or (reader is not None and reader.is_error):
         why = r.error or (f"exit {r.code}" if r.code else "it reported an error")
-        raise CraftError(f"{name} stopped: {why}.\n{r.tail(12)}", f"Full output: {rd / 'agent.log'}. Fix the cause, then `craft run` carries on.")
+        login = f"If it needs signing in: {spec['login']}.\n" if spec.get("login") else ""
+        raise CraftError(f"{name} stopped: {why}.\n{r.tail(12)}", f"{login}Full output: {rd / 'agent.log'}. Fix the cause, then `craft run` carries on.")
     reply = reader.reply if reader is not None else r.tail(40)
     write_atomic(rd / "reply.md", reply)
     return reply

{craftkit-0.3.0 → craftkit-0.3.1}/craft_kit/cli.py

@@ -8,6 +8,7 @@
   craft answer                    answer the builder's questions
   craft brief                     print the builder's brief (to paste into any agent)
   craft open                      open the result
+  craft agents                    which coding agents are installed, and how to get one
   craft skill [--install DIR]     print or install the SKILL.md this tool follows
 """
 
@@ -114,6 +115,7 @@ def finish(p: Project, ui: UI, res: Optional[dict], reply: str) -> None:
 
 def loop(p: Project, ui: UI, message: Optional[str], agent_name: Optional[str]) -> int:
     s = p.state
+    agent.resolve(s.get("agent"), agent_name)  # no agent: say how to get one now, not after the study
     if message:  # a new request resets the refinement budget; retries never do
         s["rounds_used"] = 0
         s["unchanged"] = 0
@@ -194,6 +196,32 @@ def cmd_new(a, ui: UI) -> int:
     ui.header(p.state["name"], f"{kind} · {stack} · {p.mode()}")
     ui.step("done", "new", str(folder))
     ui.say(f"   {ui.dim('add pictures to')} {folder / 'reference'}{ui.dim(', then:')} cd {folder.name} && craft run")
+    if not agent.installed():
+        ui.say("")
+        ui.warn("No coding agent found yet: `craft run` needs one.")
+        agent.guide(ui)
+    return 0
+
+
+def cmd_agents(a, ui: UI) -> int:
+    table = tables.agents()
+    found = agent.installed(table)
+    for n in tables.AGENT_ORDER:
+        if n not in table:
+            continue
+        spec = table[n]
+        title = spec.get("title", n)
+        where = agent.proc.which(spec["argv"][0])
+        if where:
+            ui.step("done", n, f"{title} · {where}" + ("  ← used by default" if found and n == found[0] else ""), stage="ready")
+        else:
+            ui.step("todo", n, f"{title} · not installed" + (f": {spec.get('install', 'install ' + spec['argv'][0])}" if found else ""))
+    if not found:
+        ui.say("")
+        ui.warn("No coding agent found.")
+        agent.guide(ui)
+    else:
+        ui.say(f"   {ui.dim('pick another with')} craft run --agent NAME {ui.dim('or')} CRAFT_AGENT=NAME")
     return 0
 
 
@@ -336,6 +364,7 @@ def parser() -> argparse.ArgumentParser:
                           ("open", cmd_open, "open the result")):
         sub.add_parser(name, help=hlp).set_defaults(fn=fn)
     sub.add_parser("home", help="the home screen: past creations and a new project").set_defaults(fn=cmd_home)
+    sub.add_parser("agents", help="which coding agents are installed, and how to get one").set_defaults(fn=cmd_agents)
     s = sub.add_parser("skill", help="print or install SKILL.md")
     s.add_argument("--install", metavar="DIR", help="skills folder, e.g. ~/.claude/skills")
     s.set_defaults(fn=cmd_skill)
@@ -370,9 +399,7 @@ def main(argv: Optional[list] = None) -> int:
     try:
         return a.fn(a, ui)
     except CraftError as e:
-        ui.error(e.message)
-        if e.fix:
-            ui.say(f"   {ui.dim(e.fix)}")
+        ui.report(e)
         return 2
     except KeyboardInterrupt:
         ui.say("")

{craftkit-0.3.0 → craftkit-0.3.1}/craft_kit/home.py

@@ -145,6 +145,12 @@ class Home:
         self.line()
         if describe:
             self.describe()
+        from . import agent
+
+        if not agent.installed():  # say it before anyone starts a project
+            ui = self.ui
+            self.line(f"  {ui.yellow('!')} No coding agent found: install Claude Code, Codex or Gemini CLI {ui.dim('(details: craft agents)')}")
+            self.line()
 
     def describe(self) -> None:
         """What the tool does, in a few lines, on the home screen."""
@@ -203,9 +209,7 @@ class Home:
         try:
             pause = action() is not False
         except CraftError as e:
-            self.ui.error(e.message)
-            if e.fix:
-                self.ui.say(f"   {self.ui.dim(e.fix)}")
+            self.ui.report(e)
         except KeyboardInterrupt:
             self.ui.say(f"\n   {self.ui.dim('stopped')}")
         if pause:
@@ -357,6 +361,13 @@ class Home:
             p = Project.create(folder, target, request, kind, stack, deep, allow_run)
             ui.step("done", "new", f"{folder}  ·  {kind} · {stack} · {p.mode()}")
             result["path"] = str(folder)
+            from . import agent
+
+            if not agent.installed():
+                ui.say("")
+                ui.warn("No coding agent found yet: building needs one.")
+                agent.guide(ui)
+                return True
             if ui.choose("Start building now?", ["Yes, start", "Later"]).startswith("Yes"):
                 ui.say("")
                 from . import cli

{craftkit-0.3.0 → craftkit-0.3.1}/craft_kit/tables.py

@@ -93,10 +93,28 @@ AGENTS: dict[str, dict] = {
         "stream": "claude-json",
         "resume": ["--resume", "{session}"],
         "lost": "No conversation found",
+        "title": "Claude Code",
+        "install": "npm install -g @anthropic-ai/claude-code",
+        "alt": {"darwin": "curl -fsSL https://claude.ai/install.sh | bash", "linux": "curl -fsSL https://claude.ai/install.sh | bash", "win32": "irm https://claude.ai/install.ps1 | iex   (PowerShell)"},
+        "login": "run `claude` once and sign in (Claude account or API key)",
+    },
+    "codex": {
+        "argv": ["codex", "exec", "--full-auto", "-"],
+        "stream": "text",
+        "title": "Codex",
+        "install": "npm install -g @openai/codex",
+        "login": "run `codex` once and sign in (ChatGPT account or API key)",
+    },
+    "gemini": {
+        "argv": ["gemini", "--yolo"],
+        "stream": "text",
+        "title": "Gemini CLI",
+        "install": "npm install -g @google/gemini-cli",
+        "alt": {"darwin": "brew install gemini-cli"},
+        "login": "run `gemini` once and sign in (a Google account has a free tier)",
     },
-    "codex": {"argv": ["codex", "exec", "--full-auto", "-"], "stream": "text"},
-    "gemini": {"argv": ["gemini", "--yolo"], "stream": "text"},
 }
+NODE_URL = "https://nodejs.org"  # npm, used by the install commands above, comes with Node.js
 AGENT_ORDER = ["claude", "codex", "gemini"]
 
 

{craftkit-0.3.0 → craftkit-0.3.1}/craft_kit/ui.py

@@ -152,6 +152,18 @@ class UI:
     def error(self, text: str) -> None:
         self.say(f" {self.red('✗')} {text}")
 
+    def warn(self, text: str) -> None:
+        self.say(f" {self.yellow('!')} {text}")
+
+    def report(self, e) -> None:
+        """A CraftError: what went wrong, then what to do (its guide, or its one-line fix)."""
+        self.error(e.message)
+        if getattr(e, "guide", None):
+            e.guide(self)
+        elif getattr(e, "fix", ""):
+            for line in e.fix.splitlines():
+                self.say(f"   {self.dim(line)}")
+
     def live(self, label: str, stage: Optional[str] = None) -> "Live":
         return Live(self, label, stage)
 

{craftkit-0.3.0 → craftkit-0.3.1}/craft_kit/workspace.py

@@ -35,10 +35,11 @@ IGNORED = {"node_modules", "target", "dist", "out", "build", ".git", "__pycache_
 class CraftError(Exception):
     """A failure with a plain-English remediation."""
 
-    def __init__(self, message: str, fix: str = ""):
+    def __init__(self, message: str, fix: str = "", guide=None):
         super().__init__(message)
         self.message = message
         self.fix = fix
+        self.guide = guide  # optional callable(ui): a longer, formatted remediation
 
 
 def write_atomic(path: Path, data: str) -> None:
@@ -203,7 +204,7 @@ class Project:
             raise CraftError(f"{root / STATE} can't be read.", "Fix or delete the file; it is JSON.")
         v = state.get("version")
         if not isinstance(v, int) or v > VERSION:
-            raise CraftError(f"{STATE} says version {v}; this craft reads version {VERSION}.", "Update craft (`pipx upgrade craftkit`, `uv tool upgrade craftkit` or `npm update -g craftkit`).")
+            raise CraftError(f"{STATE} says version {v}; this craft reads version {VERSION}.", "Update craft (`pipx upgrade craftkit`, `uv tool upgrade craftkit` or `npm update -g craftkit-cli`).")
         # migrations go here as versions are added
         state.setdefault("steps", {s: "todo" for s in STEPS})
         remember(root)

{craftkit-0.3.0 → craftkit-0.3.1/craftkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: craftkit
-Version: 0.3.0
+Version: 0.3.1
 Summary: Study → build → check → refine any software, from the terminal, with your coding agent.
 License-Expression: MIT OR Apache-2.0
 Keywords: cli,coding-agent,claude-code,codex,gemini,rebuild,skill
@@ -23,7 +23,7 @@ Dynamic: license-file
 > **In English:** `craft` rebuilds any software (website, CLI, app, game, library) with the coding
 > agent you already use (Claude Code, Codex, Gemini CLI): it studies the original, briefs the agent,
 > checks the result against the original and sends it back until it holds. Install with
-> `npm install -g craftkit` or `pipx install craftkit`, then type `craft`.
+> `npm install -g craftkit-cli` or `pipx install craftkit`, then type `craft`.
 
 La méthode de Craft Anything, réduite à l'essentiel : **étudier → construire → vérifier → affiner**,
 pour recréer ou construire n'importe quel logiciel (site web, outil en ligne de commande, application,
@@ -66,16 +66,16 @@ construction bleu, affinage violet, vérification ambre, prêt vert.
 Gratuit, au choix :
 
 ```sh
-npm install -g craftkit        # avec Node ; il faut aussi Python 3.9+ sur la machine
-pipx install craftkit          # ou : uv tool install craftkit
+npm install -g craftkit-cli   # avec Node ; il faut aussi Python 3.9+ sur la machine
+pipx install craftkit             # ou : uv tool install craftkit
 ```
 
-Pour l'essayer sans rien installer : `npx craftkit` ou `uvx craftkit`.
+Pour l'essayer sans rien installer : `npx craftkit-cli` ou `uvx craftkit`.
 Ensuite, le skill pour Claude Code (tous les projets) : `craft skill --install ~/.claude/skills`.
 
 Les deux paquets contiennent exactement le même programme Python (aucune dépendance) ; celui de npm
 le lance avec le Python de la machine (`CRAFT_PYTHON=/chemin/vers/python3` pour en choisir un).
-Mise à jour : `npm update -g craftkit`, `pipx upgrade craftkit` ou `uv tool upgrade craftkit`.
+Mise à jour : `npm update -g craftkit-cli`, `pipx upgrade craftkit` ou `uv tool upgrade craftkit`.
 
 Depuis les sources : `pipx install .` dans ce dossier, ou `python3 -m craft_kit …` sans installer.
 
@@ -122,6 +122,7 @@ craft open                                  # ouvrir le résultat
 | `craft status` | où en est le projet |
 | `craft answer` | répondre aux questions de l'agent |
 | `craft brief` | afficher la tâche, pour la coller dans n'importe quel agent |
+| `craft agents` | les agents de code installés, et comment en installer un |
 | `craft skill [--install DOSSIER]` | afficher ou installer le SKILL.md |
 
 Options de `new` : `--kind website|cli|app|game|tool`, `--stack rust|python|react|html|…`,
@@ -149,6 +150,19 @@ propres outils.
 
 ## Agents
 
+`craft` n'écrit pas le code lui-même : il faut un agent de code sur la machine. Sans agent, `craft`
+le dit dès l'écran d'accueil, à `craft new` et au début de `craft run` (avant l'étude), avec les
+commandes exactes ; `craft agents` montre ce qui est trouvé :
+
+| Agent | Installer | Puis, une fois |
+|-------|-----------|----------------|
+| Claude Code | `npm install -g @anthropic-ai/claude-code` (ou `curl -fsSL https://claude.ai/install.sh \| bash`) | lancer `claude` et se connecter |
+| Codex | `npm install -g @openai/codex` | lancer `codex` et se connecter |
+| Gemini CLI | `npm install -g @google/gemini-cli` (ou `brew install gemini-cli`) | lancer `gemini` et se connecter (offre gratuite avec un compte Google) |
+
+Sans agent du tout : `craft brief` affiche la tâche, à coller dans n'importe quel assistant de code
+(Cursor, Copilot…) ouvert dans le dossier du projet, puis `craft check`.
+
 Ordre par défaut : `claude`, `codex`, `gemini` (le premier installé). Choisir : `--agent codex` ou
 `CRAFT_AGENT=codex`. La tâche est envoyée sur l'entrée standard (jamais en argument : elle peut être
 longue). Ajouter ou modifier un agent dans `~/.config/craft/agents.json` :

{craftkit-0.3.0 → craftkit-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "craftkit"
-version = "0.3.0"
+version = "0.3.1"
 description = "Study → build → check → refine any software, from the terminal, with your coding agent."
 readme = "README.md"
 requires-python = ">=3.9"