Skip to content

Commit 3a6d7c4

Browse files
committed
ai: claude-code page renamed to agent-plugins, documented Codex
1 parent ddc7e0d commit 3a6d7c4

12 files changed

Lines changed: 58 additions & 36 deletions

‎ai/cs/@home.texy‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ Mění se i ladění. Místo kopírování stack trace do chatu řeknete "koukni
6969
Agent, který zná Nette
7070
======================
7171

72-
**[Plugin pro Claude Code |agent-plugins]** dodá to, co ve vašem kódu nikde nenajde: jak se věci v Nette dělají. Celá rodina skills pokrývá architekturu, formuláře, databázi, komponenty, bezpečnost, Latte, NEON a další. Každý se zapne sám, jakmile na jeho téma přijde řeč. Zeptáte se na validaci formuláře a naskočí skill pro formuláře. Zeptáte se na BlueScreen a naskočí ten pro Tracy.
72+
**[Pluginy pro Claude Code a Codex |agent-plugins]** dodají to, co ve vašem kódu nikde nenajde: jak se věci v Nette dělají. Celá rodina skills pokrývá architekturu, formuláře, databázi, komponenty, bezpečnost, Latte, NEON a další. Každý se zapne sám, jakmile na jeho téma přijde řeč. Zeptáte se na validaci formuláře a naskočí skill pro formuláře. Zeptáte se na BlueScreen a naskočí ten pro Tracy.
7373

7474
Výsledek vypadá, jako by ho psal někdo, kdo Nette dělá roky, ne jako obecné PHP poslepované z útržků.
7575

@@ -80,7 +80,7 @@ Jak začít
8080
Celé nastavení zabere zhruba deset minut:
8181

8282
1. [Nainstalujte si AI nástroj |getting-started], doporučujeme Claude Code
83-
2. [Přidejte plugin pro Nette |agent-plugins], aby agent znal framework
83+
2. [Přidejte pluginy pro Nette |agent-plugins], aby agent znal framework
8484
3. [Nastavte MCP Inspector |mcp-inspector], aby znal *vaši* aplikaci
8585

8686
Pak už jen popište, co chcete, zavřete agenta do smyčky a nechte ho pracovat. Až budete chtít z agenta vytěžit víc, přečtěte si [Vibe coding v praxi |vibe-coding].

‎ai/cs/@left-menu.texy‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
- [Úvod |@home]
22
- [Začínáme |getting-started]
3-
- [Plugin pro Claude Code |agent-plugins]
3+
- [Pluginy pro agenty |agent-plugins]
44
- [MCP Inspector |mcp-inspector]
55
- [Vibe coding v praxi |vibe-coding]

‎ai/cs/vibe-coding.texy‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -222,7 +222,7 @@ AI je opravdu dobrá, ale pořád je to asistent. Za výsledný kód zodpovídá
222222
Ignorovat hlášení linteru
223223
-------------------------
224224

225-
Pokud používáte [pluginy pro Claude Code |agent-plugins], kontrolují vám automaticky soubory PHP, Latte, NEON, JSON i JavaScript. Když některý ohlásí chybu, AI o ní ví. Místo ručního opravování prostě řekněte:
225+
Pokud používáte [pluginy pro Claude Code nebo Codex |agent-plugins], kontrolují vám automaticky soubory PHP, Latte, NEON, JSON i JavaScript. Když některý ohlásí chybu, AI o ní ví. Místo ručního opravování prostě řekněte:
226226

227227
```
228228
Oprav chybu, kterou jsi právě udělal.

‎ai/en/@home.texy‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ Debugging changes shape too. Instead of copying a stack trace into a chat window
6969
Nette Knowledge, Built In
7070
=========================
7171

72-
The **[Claude Code plugin |agent-plugins]** supplies the part that is nowhere in your codebase: how things are actually done in Nette. A whole family of skills covering architecture, forms, database, components, security, Latte, NEON and more, each one switching itself on when the conversation turns to its topic. Ask about form validation and the forms skill wakes up. Ask about a BlueScreen and the Tracy one does.
72+
The **[plugins for Claude Code and Codex |agent-plugins]** supply the part that is nowhere in your codebase: how things are actually done in Nette. A whole family of skills covering architecture, forms, database, components, security, Latte, NEON and more, each one switching itself on when the conversation turns to its topic. Ask about form validation and the forms skill wakes up. Ask about a BlueScreen and the Tracy one does.
7373

7474
What comes out reads like an experienced Nette developer wrote it, not like generic PHP stitched together from snippets.
7575

@@ -80,7 +80,7 @@ Get Started
8080
The whole setup takes about ten minutes:
8181

8282
1. [Install your AI tool |getting-started] - we recommend Claude Code
83-
2. [Add the Nette plugin |agent-plugins] so the agent knows the framework
83+
2. [Add the Nette plugins |agent-plugins] so the agent knows the framework
8484
3. [Set up MCP Inspector |mcp-inspector] so it knows *your* application
8585

8686
Then describe what you want, close the agent into the loop, and let it work. When you want to get more out of your agent, read [Vibe Coding in Practice |vibe-coding].

‎ai/en/@left-menu.texy‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
- [Overview |@home]
22
- [Getting Started |getting-started]
3-
- [Claude Code Plugin |agent-plugins]
3+
- [Agent Plugins |agent-plugins]
44
- [MCP Inspector |mcp-inspector]
55
- [Vibe Coding in Practice |vibe-coding]

‎ai/en/agent-plugins.texy‎

Lines changed: 42 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
1-
Claude Code Plugin
2-
******************
1+
Nette Plugins for Claude Code and Codex
2+
***************************************
33

44
<div class=perex>
55

6-
The "Nette plugin for Claude Code":https://github.com/nette/agent-plugins gives deep knowledge of the framework. Instead of generic PHP advice, you get recommendations that follow Nette conventions - from presenters and forms to Latte templates and database queries.
6+
The "Nette plugins":https://github.com/nette/agent-plugins give Claude Code and Codex deep knowledge of the framework. Instead of generic PHP advice, you get recommendations that follow Nette conventions - from presenters and forms to Latte templates and database queries.
77

8-
Together with its companion plugins, you get:
8+
The same plugins work in both tools and give you:
99
- A **broad set of skills** covering all major areas of Nette development
1010
- **Automatic validation** of PHP, Latte, NEON, JSON and JavaScript files (the `nette-lint` plugin)
1111
- **MCP Inspector integration** for real-time application introspection
@@ -16,7 +16,20 @@ Together with its companion plugins, you get:
1616
Installation
1717
============
1818

19-
If you haven't installed Claude Code yet, see the [complete setup guide |getting-started]. Once Claude Code is running, install the Nette plugin:
19+
The plugins come as a family, so you install only what you need:
20+
21+
| Plugin | Purpose |
22+
|--------|---------|
23+
| `nette` | Skills with deep framework knowledge |
24+
| `nette-lint` | Automatic validation of PHP, Latte, NEON, JSON and JavaScript |
25+
| `php-fixer` | Automatic PHP code style fixing (optional) |
26+
| `nette-dev` | Coding standards for framework contributors |
27+
28+
29+
Claude Code
30+
-----------
31+
32+
If you haven't installed Claude Code yet, see the [complete setup guide |getting-started]. Once Claude Code is running, add the Nette marketplace and install the main plugin:
2033

2134
```shell
2235
/plugin marketplace add nette/agent-plugins
@@ -29,14 +42,20 @@ For automatic validation of your PHP, Latte, NEON, JSON and JavaScript files aft
2942
/plugin install nette-lint@nette
3043
```
3144

32-
The full family of plugins:
3345

34-
| Plugin | Purpose |
35-
|--------|---------|
36-
| `nette` | Skills with deep framework knowledge |
37-
| `nette-lint` | Automatic validation of PHP, Latte, NEON, JSON and JavaScript |
38-
| `php-fixer` | Automatic PHP code style fixing (optional) |
39-
| `nette-dev` | Coding standards for framework contributors |
46+
Codex
47+
-----
48+
49+
In Codex, add the same marketplace from the command line and install the main plugin:
50+
51+
```shell
52+
codex plugin marketplace add nette/agent-plugins
53+
codex plugin add nette@nette
54+
```
55+
56+
The other plugins are installed the same way, for example `codex plugin add nette-lint@nette`. Then start a new session so Codex picks them up.
57+
58+
There is one extra step for the plugins that check or fix your files. Codex doesn't run a plugin's hooks just because you installed it; you have to approve them first. Open `/hooks` in Codex, review the hook definitions of the installed plugins and trust them. When a plugin update changes its hooks, you have to review them again.
4059

4160

4261
How Skills Work
@@ -49,7 +68,7 @@ You don't need to activate skills manually. They turn on automatically based on
4968
- Ask about "Latte filters" → the `latte-templates` skill activates
5069
- Ask about a "BlueScreen error" → the `tracy-debugging` skill activates
5170

52-
This means you get relevant, context-aware help without having to think about which skill you need.
71+
This means you get relevant, context-aware help without having to think about which skill you need. The skills are identical in both clients, so whenever the examples below say Claude, the same applies to Codex.
5372

5473

5574
Available Skills
@@ -318,9 +337,11 @@ One of the most useful features is automatic validation, provided by the separat
318337
| **JSON / JSONC** | Validates syntax after every `.json` or `.jsonc` edit and reports the exact line; comments and trailing commas are tolerated in JSONC files like `tsconfig.json` or `.vscode/*.json` |
319338
| **JavaScript / TypeScript** | Runs `eslint --fix` after every `.js`, `.ts`, `.mjs` or `.mts` edit (only if the project has an ESLint config) |
320339

321-
If there's a syntax error in any of these files, Claude knows about it immediately and can suggest a fix. No more discovering errors in the browser.
340+
If there's a syntax error in any of these files, the agent knows about it immediately and can suggest a fix. No more discovering errors in the browser.
341+
342+
The checks run after the agent edits a file with its own editing tools. When it changes files through shell commands instead, no hook runs, so it's worth asking it to run your project's checks afterwards.
322343

323-
The plugin looks for the project's tools and configs (`latte-lint`, `vendor/bin/neon-lint`, the ESLint config) upwards from the edited file, not just in the folder where Claude Code is running. So even if you keep several applications in one repository and run Claude Code from its root, each file is still checked with the right tool for its application. The search stops one level above the nearest `.git` folder, so tools from unrelated projects elsewhere on the disk are never picked up.
344+
The plugin looks for the project's tools and configs (`latte-lint`, `vendor/bin/neon-lint`, the ESLint config) upwards from the edited file, not just in the folder where the agent is running. So even if you keep several applications in one repository and start the agent from its root, each file is still checked with the right tool for its application. The search stops one level above the nearest `.git` folder, so tools from unrelated projects elsewhere on the disk are never picked up.
324345

325346
Sometimes you don't want a file checked - for example `fixtures` with intentionally broken templates or code used in tests. You can skip specific paths by creating a `.nette-claude.json` file in your project, where each key is a hook name with a list of paths to ignore:
326347

@@ -344,7 +365,8 @@ Plugin for Framework Contributors
344365
If you're contributing to Nette itself, there's an additional plugin with coding standards:
345366

346367
```shell
347-
/plugin install nette-dev@nette
368+
/plugin install nette-dev@nette # Claude Code
369+
codex plugin add nette-dev@nette # Codex
348370
```
349371

350372
| Skill | What It Covers |
@@ -358,14 +380,14 @@ If you're contributing to Nette itself, there's an additional plugin with coding
358380
Automatic PHP Style Fixing
359381
==========================
360382

361-
For automatic code style fixing after every PHP file edit, install the optional php-fixer plugin:
383+
For automatic code style fixing after every PHP file edit, install the optional php-fixer plugin. In Claude Code:
362384

363385
```shell
364386
/plugin install php-fixer@nette
365387
/install-php-fixer
366388
```
367389

368-
The second command installs `nette/coding-standard` globally. After that, every PHP file you edit will be automatically formatted according to Nette coding standards.
390+
The second command installs `nette/coding-standard` globally. In Codex, install the plugin with `codex plugin add php-fixer@nette` and then pick the `install-php-fixer` skill, which does the same. After that, every PHP file you edit will be automatically formatted according to Nette coding standards.
369391

370392
Because the fixer **rewrites your files**, it's important to keep it away from code you don't want reformatted - typically `fixtures` with intentionally crafted formatting. Exclude such paths with a `fix-php-style` entry in `.nette-claude.json`:
371393

@@ -397,7 +419,7 @@ The plugin also comes with the `php-auto-fixer` skill, which teaches Claude abou
397419
MCP Inspector Integration
398420
=========================
399421

400-
The plugin works even better with [MCP Inspector |mcp-inspector] - a tool that lets Claude see your actual application state. With MCP Inspector, Claude can:
422+
The plugins work even better with [MCP Inspector |mcp-inspector] - a tool that lets the agent see your actual application state. With MCP Inspector, Claude can:
401423

402424
- Query your real database schema instead of guessing
403425
- List your registered DI services and their configuration
@@ -411,6 +433,6 @@ composer require --dev nette/mcp-inspector:@dev
411433
vendor/bin/mcp-inspector init
412434
```
413435

414-
Then restart Claude Code. See the [MCP Inspector documentation |mcp-inspector] for all the available tools.
436+
Then restart Claude Code. Codex isn't registered by `init`, so add the server to its configuration yourself as described in [Other AI Tools |mcp-inspector#other-ai-tools]. See the [MCP Inspector documentation |mcp-inspector] for all the available tools.
415437

416438
{{repo: nette/agent-plugins}}

‎ai/en/getting-started.texy‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,10 +42,10 @@ curl -fsSL https://claude.ai/install.sh | bash
4242
On macOS, you can alternatively use Homebrew:
4343

4444
```shell
45-
brew install --cask agent-plugins
45+
brew install --cask claude-code
4646
```
4747

48-
After installation, skip to [Starting Claude Code |#starting-agent-plugins].
48+
After installation, skip to [Starting Claude Code |#starting-claude-code].
4949

5050

5151
Installation on Windows via WSL
@@ -233,7 +233,7 @@ Cursor is a popular AI-first code editor. To use MCP Inspector with Cursor:
233233

234234
3. Restart Cursor
235235

236-
Note: Cursor doesn't have the Nette-specific skills that the Claude Code plugin provides, but MCP Inspector will still give it access to your application's services, database, routes, and logs.
236+
Note: Cursor doesn't have the Nette-specific skills that the [Nette plugins |agent-plugins] provide, but MCP Inspector will still give it access to your application's services, database, routes, and logs.
237237

238238

239239
VS Code
@@ -254,7 +254,7 @@ What's Next
254254
You're now ready for AI-assisted Nette development! Here's where to go from here:
255255

256256
- [MCP Inspector |mcp-inspector] - Learn about every introspection tool
257-
- [Claude Code Plugin |agent-plugins] - Explore all the skills (Claude Code users)
257+
- [Agent Plugins |agent-plugins] - Explore all the skills (Claude Code and Codex users)
258258
- [Vibe Coding in Practice |vibe-coding] - Get the most out of your AI assistant
259259

260260
{{description: Set up vibe coding with Nette in about ten minutes: install Claude Code, add the Nette plugin, and connect MCP Inspector to your application.}}

‎ai/en/vibe-coding.texy‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -222,7 +222,7 @@ AI is very good, but it's still an assistant. You're the developer responsible f
222222
Ignoring Validation Feedback
223223
----------------------------
224224

225-
If you're using the [Claude Code plugins |agent-plugins], they validate your PHP, Latte, NEON, JSON and JavaScript files automatically. When one reports an error, the AI knows about it. Instead of manually fixing the error, just say:
225+
If you're using the [Nette plugins for Claude Code or Codex |agent-plugins], they validate your PHP, Latte, NEON, JSON and JavaScript files automatically. When one reports an error, the AI knows about it. Instead of manually fixing the error, just say:
226226

227227
```
228228
Fix the error you just created.

‎tools/cs/@home.texy‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Kvalita kódu
2121

2222
Umělá inteligence
2323
-----------------
24-
- [Claude Code plugin |https://ai.nette.org/en/agent-plugins] naučí Claude Code konvence Nette: skills, automatická validace Latte/NEON/JS a integrace MCP.
24+
- [Pluginy pro Claude Code a Codex |https://ai.nette.org/en/agent-plugins] naučí AI agenty konvence Nette: skills, automatická validace Latte/NEON/JS a integrace MCP.
2525
- [MCP Inspector |https://ai.nette.org/en/mcp-inspector] zpřístupní AI reálný stav aplikace: DI služby, schéma databáze, routy i Tracy logy.
2626

2727

‎tools/en/@home.texy‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Code Quality
2121

2222
Artificial Intelligence
2323
-----------------------
24-
- [Claude Code plugin |https://ai.nette.org/en/agent-plugins] teaches Claude Code the Nette conventions: skills, automatic validation of Latte/NEON/JS, and MCP integration.
24+
- [Plugins for Claude Code and Codex |https://ai.nette.org/en/agent-plugins] teach AI agents the Nette conventions: skills, automatic validation of Latte/NEON/JS, and MCP integration.
2525
- [MCP Inspector |https://ai.nette.org/en/mcp-inspector] gives AI the real state of your application: DI services, database schema, routes and Tracy logs.
2626

2727

0 commit comments

Comments
 (0)