PHPackages netresearch/t3-cowriter - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. netresearch/t3-cowriter ActiveTypo3-cms-extension netresearch/t3-cowriter ======================= With the help of AI you can now work on a page together with a cowriter - a digital assistant that helps you to write your content. v3.1.0(1mo ago)1010.8k—0%1[1 issues](https://github.com/netresearch/t3x-cowriter/issues)GPL-3.0-or-laterPHPPHP ^8.2CI passing Since Jan 14Pushed 1mo ago5 watchersCompare [ Source](https://github.com/netresearch/t3x-cowriter)[ Packagist](https://packagist.org/packages/netresearch/t3-cowriter)[ Docs](https://github.com/netresearch/t3x-cowriter)[ RSS](/packages/netresearch-t3-cowriter/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (6)Versions (24)Used By (0) TYPO3 Extension: t3\_cowriter ============================= [](#typo3-extension-t3_cowriter) [![CI](https://github.com/netresearch/t3x-cowriter/actions/workflows/ci.yml/badge.svg)](https://github.com/netresearch/t3x-cowriter/actions/workflows/ci.yml)[![codecov](https://camo.githubusercontent.com/fc746f9748cd84d0c2bb745e50daccf1a1d25eca57f6ada301b8378f47c77e96/68747470733a2f2f636f6465636f762e696f2f67682f6e657472657365617263682f7433782d636f7772697465722f67726170682f62616467652e737667)](https://codecov.io/gh/netresearch/t3x-cowriter) [![OpenSSF Scorecard](https://camo.githubusercontent.com/3ec420f6cbff305588900f06ae97cba0a163cbb928fe115743cb87d086d2ac6c/68747470733a2f2f6170692e736563757269747973636f726563617264732e6465762f70726f6a656374732f6769746875622e636f6d2f6e657472657365617263682f7433782d636f7772697465722f6261646765)](https://securityscorecards.dev/viewer/?uri=github.com/netresearch/t3x-cowriter)[![OpenSSF Best Practices](https://camo.githubusercontent.com/f9dcd1c577759f15c4aee1c8dc9d1d0d7b3dd89f3f8b67fc33445e4d5d76ff0a/68747470733a2f2f7777772e626573747072616374696365732e6465762f70726f6a656374732f31313835332f6261646765)](https://www.bestpractices.dev/projects/11853)[![SLSA 3](https://camo.githubusercontent.com/dc294f15fb5f1c96307863a1e96860310be940504e7ee370cee94bf4400cbac9/68747470733a2f2f736c73612e6465762f696d616765732f67682d62616467652d6c6576656c332e737667)](https://slsa.dev) [![PHPStan](https://camo.githubusercontent.com/d18b9a987aa81e64470a11caecf72caa66597c9ebd6b307bd1c2cb7a752b0dff/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c25323031302d627269676874677265656e2e737667)](https://phpstan.org/)[![PHP 8.2+](https://camo.githubusercontent.com/0f16581d1180dbfd4c0e13166ec1267d4ad2f2fab8281ea6d6b284cf5c65d921/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c75652e737667)](https://www.php.net/)[![TYPO3 v13](https://camo.githubusercontent.com/39b7ea332fe50c744dd651e5de37137e22f86909ed8327d044205f6a1ce9dbde/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d7631332d6f72616e67652e737667)](https://typo3.org/)[![TYPO3 v14](https://camo.githubusercontent.com/4408aa531f9e1f713217cffa7f7143a33dbd648599f9d048211a1c8afe2c06a2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d7631342d6f72616e67652e737667)](https://typo3.org/)[![License: GPL v3](https://camo.githubusercontent.com/7b8bafba66ad667644f929650e95999ed543861daa523111404f5f1d5f9b6fd4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d47504c5f76332d626c75652e737667)](https://www.gnu.org/licenses/gpl-3.0.en.html)[![Latest Release](https://camo.githubusercontent.com/05aa285c449b02ca9a08a252d3b8b9bf348dd24348a0f646256613d9168338dc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6e657472657365617263682f7433782d636f777269746572)](https://github.com/netresearch/t3x-cowriter/releases)[![Contributor Covenant](https://camo.githubusercontent.com/817d29b29dcac8a671e6670fb01f792302989c853922a3714322e78af3dc7c85/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e7472696275746f72253230436f76656e616e742d332e302d3462616161612e737667)](CODE_OF_CONDUCT.md) [![Composer](https://camo.githubusercontent.com/6bf7987f28c9bf01a4c3cf9933adef2ae5c9aac58b40055104149604e3d38552/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f74335f636f7772697465722f636f6d706f7365722f736869656c64732e737667)](https://camo.githubusercontent.com/6bf7987f28c9bf01a4c3cf9933adef2ae5c9aac58b40055104149604e3d38552/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f74335f636f7772697465722f636f6d706f7365722f736869656c64732e737667)[![Downloads](https://camo.githubusercontent.com/5272aaa87ae6c0e811593d72e86100dcca6c9fd7301f2fb2ad431fe3b1fd328c/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f74335f636f7772697465722f646f776e6c6f6164732f736869656c64732e737667)](https://camo.githubusercontent.com/5272aaa87ae6c0e811593d72e86100dcca6c9fd7301f2fb2ad431fe3b1fd328c/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f74335f636f7772697465722f646f776e6c6f6164732f736869656c64732e737667)[![Extension](https://camo.githubusercontent.com/69e3001471894096c010f6468c8c8aabe50dae432464255cc29d05d62e7c8bc4/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f74335f636f7772697465722f657874656e73696f6e2f736869656c64732e737667)](https://camo.githubusercontent.com/69e3001471894096c010f6468c8c8aabe50dae432464255cc29d05d62e7c8bc4/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f74335f636f7772697465722f657874656e73696f6e2f736869656c64732e737667)[![Stability](https://camo.githubusercontent.com/af4b519742753d8c5a647e4801258f3d30db648d97c9c08b2ee9c46bed631f39/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f74335f636f7772697465722f73746162696c6974792f736869656c64732e737667)](https://camo.githubusercontent.com/af4b519742753d8c5a647e4801258f3d30db648d97c9c08b2ee9c46bed631f39/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f74335f636f7772697465722f73746162696c6974792f736869656c64732e737667)[![TYPO3](https://camo.githubusercontent.com/b559f6fa6667ddadad204a332437285b31712439f8b091c5f07fce61dd240caa/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f74335f636f7772697465722f7479706f332f736869656c64732e737667)](https://camo.githubusercontent.com/b559f6fa6667ddadad204a332437285b31712439f8b091c5f07fce61dd240caa/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f74335f636f7772697465722f7479706f332f736869656c64732e737667)[![Version](https://camo.githubusercontent.com/c076c128b85b82bb8c0244bc8a6e58c31f9a68e6d9edc11147630789e90b8a46/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f74335f636f7772697465722f76657273696f6e2f736869656c64732e737667)](https://camo.githubusercontent.com/c076c128b85b82bb8c0244bc8a6e58c31f9a68e6d9edc11147630789e90b8a46/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f74335f636f7772697465722f76657273696f6e2f736869656c64732e737667) AI-powered content assistant for TYPO3 CKEditor - write better content with help from AI. [![Cowriter dialog in TYPO3 v14 backend](Documentation/Images/CowriterHero.png)](Documentation/Images/CowriterHero.png) Features -------- [](#features) - **Task-based dialog**: Select from predefined tasks (Improve, Summarize, Extend, Fix Grammar, Translate) with result preview before inserting - **Vision / Alt Text**: Analyze images and generate descriptive alt text via the CKEditor toolbar - **Translation**: Translate selected text into 10+ languages directly from the toolbar dropdown - **Prompt Templates**: Load reusable prompt presets from the backend for consistent content generation - **Tool Calling**: Structured function calling that lets the LLM query TYPO3 content during conversations - **CKEditor Integration**: Four toolbar components — main dialog, vision, translation, and templates - **Multi-Provider Support**: Works with all LLM providers supported by nr-llm (OpenAI, Claude, Gemini, etc.) - **Secure Backend Proxy**: API keys never exposed to frontend — all requests proxied through TYPO3 backend - **Context control**: Choose between selected text or full content element as context - **Ad-hoc instructions**: Add custom instructions per request (e.g., "Write in formal tone") - **Rate limiting**: 20 requests/minute per backend user - **Streaming**: Server-Sent Events for real-time completions - **Content sanitization**: Frontend DOMParser-based sanitization with CKEditor's HTML processing pipeline Requirements ------------ [](#requirements) - PHP 8.2+ - TYPO3 v13 or v14 - [netresearch/nr-llm](https://github.com/netresearch/t3x-nr-llm) extension (LLM provider abstraction) Installation ------------ [](#installation) Install via Composer: ``` composer require netresearch/t3-cowriter ``` Configuration ------------- [](#configuration) ### 1. Configure nr-llm Extension [](#1-configure-nr-llm-extension) First, set up at least one LLM provider in the nr-llm extension: 1. Navigate to **Admin Tools → LLM Management** 2. Add a provider (e.g., OpenAI with your API key) 3. Create a model configuration 4. Create an LLM configuration and set it as default ### 2. Add CKEditor Preset [](#2-add-ckeditor-preset) #### Option A: Use the included preset [](#option-a-use-the-included-preset) Add the cowriter preset to your Page TSconfig: ``` RTE.default.preset = cowriter ``` #### Option B: Extend your existing preset [](#option-b-extend-your-existing-preset) Add to your RTE configuration YAML: ``` editor: config: importModules: - { module: '@netresearch/t3_cowriter/cowriter', exports: ['Cowriter'] } toolbar: items: - cowriter - cowriterVision - cowriterTranslate - cowriterTemplates ``` Usage ----- [](#usage) 1. Open a content element with a rich text field in the TYPO3 backend 2. Optionally select text in CKEditor (or leave empty to use full content) 3. Click the **Cowriter** button in the toolbar 4. A dialog opens where you can: - **Select a task** (Improve Text, Summarize, Extend, Fix Grammar, Translate to EN/DE) - **Choose context scope** — selected text or whole content element - **Add instructions** — optional ad-hoc rules like "Write in formal tone" 5. Click **Execute** — the task is sent to the LLM 6. Review the result in the preview area 7. Click **Insert** to replace content, or **Retry** to re-execute ### Available tasks [](#available-tasks) Tasks are managed in the nr-llm extension (`tx_nrllm_task` table) with `category = 'content'`. Default tasks: TaskDescriptionImprove TextEnhance readability and qualitySummarizeCreate a concise summaryExtend / ElaborateAdd depth and detailFix Grammar & SpellingCorrect grammar and spellingTranslate to EnglishTranslate to EnglishTranslate to GermanTranslate to GermanArchitecture ------------ [](#architecture) ``` CKEditor Toolbar ├─ cowriter → [CowriterDialog] → AIService.js → AjaxController ├─ cowriterVision → AIService.js ──────────────→ VisionController ├─ cowriterTranslate→ AIService.js ──────────────→ TranslationController ├─ cowriterTemplates→ AIService.js ──────────────→ TemplateController └─ (tool calling) → AIService.js ──────────────→ ToolController ↓ [LlmServiceManagerInterface] ↓ [nr-llm Provider] ↓ [External LLM API] ``` All LLM requests are proxied through the TYPO3 backend. API keys are stored encrypted and never exposed to the browser. Development ----------- [](#development) ### Prerequisites [](#prerequisites) - DDEV for local development - PHP 8.2+ with required extensions ### Setup [](#setup) ``` ddev start ddev composer install ddev install-v14 ``` ### Testing [](#testing) ``` # Run all quality checks (lint, phpstan, rector, code style) make ci # Run all tests (unit, functional, integration, e2e) make test # Individual test suites make test-unit # Unit tests make test-functional # Functional tests make test-integration # Integration tests make test-e2e # End-to-end tests # Code quality make lint # PHP-CS-Fixer make phpstan # PHPStan level 10 ``` ### Test Coverage [](#test-coverage) Target: >80% code coverage ``` make test-coverage open var/coverage/unit/index.html ``` Security -------- [](#security) - API keys stored in nr-llm with sodium encryption - All backend AJAX endpoints require TYPO3 authentication - Frontend DOMParser-based content sanitization via CKEditor's HTML processing pipeline - TYPO3 backend route authentication with nonce-based URL tokens - Content Security Policy (CSP) compatible Migration to v3.x ----------------- [](#migration-to-v3x) Version 3.0 requires TYPO3 v13.4+ and PHP 8.2+. It removes the frontend-only architecture and uses the nr-llm extension for provider-agnostic LLM access. API keys are no longer stored in extension settings. See [CHANGELOG.md](CHANGELOG.md) for migration details. License ------- [](#license) This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details. Contributing ------------ [](#contributing) See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines. Contact ------- [](#contact) [Netresearch DTT GmbH](https://www.netresearch.de/) - Your TYPO3 and eCommerce experts. > [Twitter](https://twitter.com/netresearch) | [LinkedIn](https://www.linkedin.com/company/netresearch/) | [GitHub](https://github.com/netresearch) ### Health Score 56 — FairBetter than 97% of packages Maintenance94 Actively maintained with recent releases Popularity31 Limited adoption so far Community19 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor1 Top contributor holds 64.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~60 days Recently: every ~28 days Total 20 Last Release 56d ago Major Versions 0.0.2 → 1.0.02023-01-25 1.2.4 → v2.0.0-alpha.12024-02-16 1.2.7 → v2.0.0-alpha.22025-11-24 v2.0.0 → v3.0.02026-03-11 PHP version history (2 changes)v2.0.0PHP ^8.2 || ^8.3 || ^8.4 v3.0.0PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/acffee6a64e18f21593794b335dd8786001148f7df89fd8372a54d3dd09d91a4?d=identicon)[netresearch](/maintainers/netresearch) --- Top Contributors [![CybotTM](https://avatars.githubusercontent.com/u/326348?v=4)](https://github.com/CybotTM "CybotTM (216 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (57 commits)")[![TheDevMinerTV](https://avatars.githubusercontent.com/u/29845135?v=4)](https://github.com/TheDevMinerTV "TheDevMinerTV (13 commits)")[![Gitsko](https://avatars.githubusercontent.com/u/17161911?v=4)](https://github.com/Gitsko "Gitsko (12 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (12 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (11 commits)")[![Thoemel42](https://avatars.githubusercontent.com/u/32194305?v=4)](https://github.com/Thoemel42 "Thoemel42 (6 commits)")[![ngolatka](https://avatars.githubusercontent.com/u/7393538?v=4)](https://github.com/ngolatka "ngolatka (2 commits)")[![olagwin](https://avatars.githubusercontent.com/u/49477230?v=4)](https://github.com/olagwin "olagwin (2 commits)")[![vergissberlin](https://avatars.githubusercontent.com/u/179964?v=4)](https://github.com/vergissberlin "vergissberlin (1 commits)")[![AndreasMueller75](https://avatars.githubusercontent.com/u/32193606?v=4)](https://github.com/AndreasMueller75 "AndreasMueller75 (1 commits)") --- Tags aickeditorcontent-generationllmopenaiphptypo3typo3-extensionaiextensionbackendtypo3cowriter ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/netresearch-t3-cowriter/health.svg) ``` [![Health](https://phpackages.com/badges/netresearch-t3-cowriter/health.svg)](https://phpackages.com/packages/netresearch-t3-cowriter) ``` ### Alternatives [leuchtfeuer/locate Locate - The users country, preferred language and other facts will be detected. Depending on configurable rules the user can be redirected to other languages or pages. Locate also provides geo blocking for configurable pages in configurable countries. 1182.8k](/packages/leuchtfeuer-locate)[netresearch/contexts Multi-channel content visibility for TYPO3 - by Netresearch 1117.4k1](/packages/netresearch-contexts)[georgringer/backend-debug Some debug helper for the TYPO3 backend 2032.4k](/packages/georgringer-backend-debug)[3m5/typo3-enhanced-backend Improves the user experience (UI/UX), provides customization options for editors and enhances the look and feel of TYPO3 backend. 105.1k](/packages/3m5-typo3-enhanced-backend) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)