You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 3a6d7c4
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: ai/cs/@home.texy
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -69,7 +69,7 @@ Mění se i ladění. Místo kopírování stack trace do chatu řeknete "koukni
69
69
Agent, který zná Nette
70
70
======================
71
71
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.
73
73
74
74
Výsledek vypadá, jako by ho psal někdo, kdo Nette dělá roky, ne jako obecné PHP poslepované z útržků.
75
75
@@ -80,7 +80,7 @@ Jak začít
80
80
Celé nastavení zabere zhruba deset minut:
81
81
82
82
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
84
84
3. [Nastavte MCP Inspector |mcp-inspector], aby znal *vaši* aplikaci
85
85
86
86
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].
Copy file name to clipboardExpand all lines: ai/cs/vibe-coding.texy
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -222,7 +222,7 @@ AI je opravdu dobrá, ale pořád je to asistent. Za výsledný kód zodpovídá
222
222
Ignorovat hlášení linteru
223
223
-------------------------
224
224
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:
Copy file name to clipboardExpand all lines: ai/en/@home.texy
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -69,7 +69,7 @@ Debugging changes shape too. Instead of copying a stack trace into a chat window
69
69
Nette Knowledge, Built In
70
70
=========================
71
71
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.
73
73
74
74
What comes out reads like an experienced Nette developer wrote it, not like generic PHP stitched together from snippets.
75
75
@@ -80,7 +80,7 @@ Get Started
80
80
The whole setup takes about ten minutes:
81
81
82
82
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
84
84
3. [Set up MCP Inspector |mcp-inspector] so it knows *your* application
85
85
86
86
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].
Copy file name to clipboardExpand all lines: ai/en/agent-plugins.texy
+42-20Lines changed: 42 additions & 20 deletions
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
-
Claude Code Plugin
2
-
******************
1
+
Nette Plugins for Claude Code and Codex
2
+
***************************************
3
3
4
4
<div class=perex>
5
5
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.
7
7
8
-
Together with its companion plugins, you get:
8
+
The same plugins work in both tools and give you:
9
9
- A **broad set of skills** covering all major areas of Nette development
10
10
- **Automatic validation** of PHP, Latte, NEON, JSON and JavaScript files (the `nette-lint` plugin)
11
11
- **MCP Inspector integration** for real-time application introspection
@@ -16,7 +16,20 @@ Together with its companion plugins, you get:
16
16
Installation
17
17
============
18
18
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 |
| `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:
20
33
21
34
```shell
22
35
/plugin marketplace add nette/agent-plugins
@@ -29,14 +42,20 @@ For automatic validation of your PHP, Latte, NEON, JSON and JavaScript files aft
29
42
/plugin install nette-lint@nette
30
43
```
31
44
32
-
The full family of plugins:
33
45
34
-
| Plugin | Purpose |
35
-
|--------|---------|
36
-
| `nette` | Skills with deep framework knowledge |
37
-
| `nette-lint` | Automatic validation of PHP, Latte, NEON, JSON and JavaScript |
| `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.
40
59
41
60
42
61
How Skills Work
@@ -49,7 +68,7 @@ You don't need to activate skills manually. They turn on automatically based on
49
68
- Ask about "Latte filters" → the `latte-templates` skill activates
50
69
- Ask about a "BlueScreen error" → the `tracy-debugging` skill activates
51
70
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.
53
72
54
73
55
74
Available Skills
@@ -318,9 +337,11 @@ One of the most useful features is automatic validation, provided by the separat
318
337
| **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` |
319
338
| **JavaScript / TypeScript** | Runs `eslint --fix` after every `.js`, `.ts`, `.mjs` or `.mts` edit (only if the project has an ESLint config) |
320
339
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.
322
343
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.
324
345
325
346
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:
326
347
@@ -344,7 +365,8 @@ Plugin for Framework Contributors
344
365
If you're contributing to Nette itself, there's an additional plugin with coding standards:
345
366
346
367
```shell
347
-
/plugin install nette-dev@nette
368
+
/plugin install nette-dev@nette # Claude Code
369
+
codex plugin add nette-dev@nette # Codex
348
370
```
349
371
350
372
| Skill | What It Covers |
@@ -358,14 +380,14 @@ If you're contributing to Nette itself, there's an additional plugin with coding
358
380
Automatic PHP Style Fixing
359
381
==========================
360
382
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:
362
384
363
385
```shell
364
386
/plugin install php-fixer@nette
365
387
/install-php-fixer
366
388
```
367
389
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.
369
391
370
392
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`:
371
393
@@ -397,7 +419,7 @@ The plugin also comes with the `php-auto-fixer` skill, which teaches Claude abou
397
419
MCP Inspector Integration
398
420
=========================
399
421
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:
401
423
402
424
- Query your real database schema instead of guessing
403
425
- List your registered DI services and their configuration
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.
After installation, skip to [Starting Claude Code |#starting-agent-plugins].
48
+
After installation, skip to [Starting Claude Code |#starting-claude-code].
49
49
50
50
51
51
Installation on Windows via WSL
@@ -233,7 +233,7 @@ Cursor is a popular AI-first code editor. To use MCP Inspector with Cursor:
233
233
234
234
3. Restart Cursor
235
235
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.
237
237
238
238
239
239
VS Code
@@ -254,7 +254,7 @@ What's Next
254
254
You're now ready for AI-assisted Nette development! Here's where to go from here:
255
255
256
256
- [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)
258
258
- [Vibe Coding in Practice |vibe-coding] - Get the most out of your AI assistant
259
259
260
260
{{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.}}
Copy file name to clipboardExpand all lines: ai/en/vibe-coding.texy
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -222,7 +222,7 @@ AI is very good, but it's still an assistant. You're the developer responsible f
222
222
Ignoring Validation Feedback
223
223
----------------------------
224
224
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:
Copy file name to clipboardExpand all lines: tools/cs/@home.texy
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@ Kvalita kódu
21
21
22
22
Umělá inteligence
23
23
-----------------
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.
25
25
- [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.
Copy file name to clipboardExpand all lines: tools/en/@home.texy
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@ Code Quality
21
21
22
22
Artificial Intelligence
23
23
-----------------------
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.
25
25
- [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.
0 commit comments