KosmoKrator

productivity

Transifex Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Transifex KosmoKrator integration.

Lua Namespace

Agents call this integration through app.integrations.transifex.*. Use lua_read_doc("integrations.transifex") inside KosmoKrator to discover the same reference at runtime.

Call Lua from the Headless CLI

Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic Transifex workflow without starting an interactive agent session.

Inline Lua call
kosmo integrations:lua --eval 'dump(app.integrations.transifex.list_projects({}))' --json
Read Lua docs headlessly
kosmo integrations:lua --eval 'print(docs.read("transifex"))' --json
kosmo integrations:lua --eval 'print(docs.read("transifex.list_projects"))' --json

Workflow file

Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.

workflow.lua
local transifex = app.integrations.transifex
local result = transifex.list_projects({})

dump(result)
Run the workflow
kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json
Namespace note. integrations:lua exposes app.integrations.transifex, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.transifex.default.* or app.integrations.transifex.work.* when you configured named credential accounts.

MCP-only Lua

If the script only needs configured MCP servers and does not need Transifex, use the narrower mcp:lua command.

MCP Lua command
# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Transifex Integration

Tools

transifex_list_projects

List all Transifex projects.

Parameters: None.

transifex_get_project

Get details of a specific Transifex project.

Parameters:

  • project_id (string, required) — The project slug or ID.

transifex_list_resources

List all resources (source files) in a Transifex project.

Parameters:

  • project_id (string, required) — The project slug or ID.

transifex_get_resource

Get details of a specific Transifex resource.

Parameters:

  • project_id (string, required) — The project slug or ID.
  • resource_id (string, required) — The resource slug or ID.

transifex_list_translations

List translations for a specific resource in a Transifex project.

Parameters:

  • project_id (string, required) — The project slug or ID.
  • resource_id (string, required) — The resource slug or ID.
  • lang_code (string, optional) — Language code to filter translations (e.g., “fr”, “de”, “ja”).

transifex_list_languages

List all languages configured for a Transifex project.

Parameters:

  • project_id (string, required) — The project slug or ID.

transifex_get_current_user

Get information about the currently authenticated Transifex user.

Parameters: None.

Raw agent markdown
# Transifex Integration

## Tools

### transifex_list_projects
List all Transifex projects.

**Parameters:** None.

### transifex_get_project
Get details of a specific Transifex project.

**Parameters:**
- `project_id` (string, required) — The project slug or ID.

### transifex_list_resources
List all resources (source files) in a Transifex project.

**Parameters:**
- `project_id` (string, required) — The project slug or ID.

### transifex_get_resource
Get details of a specific Transifex resource.

**Parameters:**
- `project_id` (string, required) — The project slug or ID.
- `resource_id` (string, required) — The resource slug or ID.

### transifex_list_translations
List translations for a specific resource in a Transifex project.

**Parameters:**
- `project_id` (string, required) — The project slug or ID.
- `resource_id` (string, required) — The resource slug or ID.
- `lang_code` (string, optional) — Language code to filter translations (e.g., "fr", "de", "ja").

### transifex_list_languages
List all languages configured for a Transifex project.

**Parameters:**
- `project_id` (string, required) — The project slug or ID.

### transifex_get_current_user
Get information about the currently authenticated Transifex user.

**Parameters:** None.
Metadata-derived Lua example
local result = app.integrations.transifex.list_projects({})
print(result)

Functions

list_projects Read

List all Transifex projects. Returns project slugs, names, descriptions, and language statistics.

Lua path
app.integrations.transifex.list_projects
Full name
transifex.transifex_list_projects
ParameterTypeRequiredDescription
No parameters.
get_project Read

Get details of a specific Transifex project including its name, description, source language, and team.

Lua path
app.integrations.transifex.get_project
Full name
transifex.transifex_get_project
ParameterTypeRequiredDescription
project_id string yes The project slug or ID (e.g., "my-project-slug").
list_resources Read

List all resources (source files) in a Transifex project. Returns resource slugs, names, types, and word/string counts.

Lua path
app.integrations.transifex.list_resources
Full name
transifex.transifex_list_resources
ParameterTypeRequiredDescription
project_id string yes The project slug or ID (e.g., "my-project-slug").
get_resource Read

Get details of a specific Transifex resource including its name, type, word count, string count, and translation progress.

Lua path
app.integrations.transifex.get_resource
Full name
transifex.transifex_get_resource
ParameterTypeRequiredDescription
project_id string yes The project slug or ID (e.g., "my-project-slug").
resource_id string yes The resource slug or ID (e.g., "my-resource-slug").
list_translations Read

List translations for a specific resource in a Transifex project. Optionally filter by language code.

Lua path
app.integrations.transifex.list_translations
Full name
transifex.transifex_list_translations
ParameterTypeRequiredDescription
project_id string yes The project slug or ID (e.g., "my-project-slug").
resource_id string yes The resource slug or ID (e.g., "my-resource-slug").
lang_code string no Optional language code to filter translations (e.g., "fr", "de", "ja").
list_languages Read

List all languages configured for a Transifex project. Returns language codes, names, and translation progress.

Lua path
app.integrations.transifex.list_languages
Full name
transifex.transifex_list_languages
ParameterTypeRequiredDescription
project_id string yes The project slug or ID (e.g., "my-project-slug").
get_current_user Read

Get information about the currently authenticated Transifex user, including username, email, and account details.

Lua path
app.integrations.transifex.get_current_user
Full name
transifex.transifex_get_current_user
ParameterTypeRequiredDescription
No parameters.