productivity
DeepL CLI for Headless Automation
Use the DeepL CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 5 read 2 write API key auth
DeepL CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The DeepL CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# DeepL CLI for Headless Automation
kosmokrator integrations:configure deepl --set api_key="$DEEPL_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call deepl.deepl_translate_text '{"text":"example_text","target_lang":"example_target_lang","source_lang":"example_source_lang"}' --json Discovery Before Execution
Agents and scripts can inspect DeepL docs and schemas before choosing a function.
kosmo integrations:docs deepl --json
kosmo integrations:docs deepl.deepl_translate_text --json
kosmo integrations:schema deepl.deepl_translate_text --json
kosmo integrations:search "DeepL" --json
kosmo integrations:list --json Useful DeepL CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
deepl.deepl_translate_text | Write | text, target_lang, source_lang | Translate text using DeepL. Supports automatic source language detection or explicit source language specification. Returns translated text with detected source language. |
deepl.deepl_list_languages | Read | type | List languages supported by DeepL. Returns language codes and names. Filter by type to get only source or target languages. |
deepl.deepl_get_usage | Read | none | Get current DeepL API usage. Returns the number of characters translated and the character limit for the current billing period. |
deepl.deepl_list_glossaries | Read | none | List all glossaries in your DeepL account. Returns glossary IDs, names, language pairs, and entry counts. |
deepl.deepl_get_glossary | Read | id | Get details of a specific DeepL glossary by ID. Returns glossary name, source/target languages, entry count, and creation timestamp. |
deepl.deepl_create_glossary | Write | name, source_lang, target_lang, entries | Create a new DeepL glossary. Glossaries define custom translations for specific terms. Entries are tab-separated pairs (source\ttarget), one per line. |
deepl.deepl_get_current_user | Read | none | Get current DeepL account information. Returns usage statistics and account details. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.