Developer Tools

Tuist

by Tuist GmbH

Overview

Tuist helps teams inspect Xcode, Gradle, and Bazel build data, test results, cache activity, previews, runner jobs, and project configuration. It also supports authorized account setup and selected test-case updates.

Tools

add_organization_member

ChatGPT

Add an existing Tuist user to an organization or update an existing member's role.

cancel_organization_invitation

ChatGPT

Cancel a pending organization invitation so its link can no longer be accepted.

clear_runner_volume

ChatGPT

Clear saved volume contents after user confirmation. This cannot be undone. Running jobs retain private copies but cannot save them; later jobs start empty. Requires account administration.

complete_project_logo_upload

ChatGPT

Commit a project logo previously uploaded via start_project_logo_upload. Verifies the upload_token, confirms the object exists in storage, and points the project at the new logo (replacing any previous one). Returns the public URL the logo is now served from.

create_organization

ChatGPT

Create a Tuist organization for the authenticated user.

create_project

ChatGPT

Create a Tuist project under an account the authenticated user can access.

get_account_token

ChatGPT

Get an account token's non-secret metadata.

get_automation_alert

ChatGPT

Get an automation alert. The alert_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/settings/automations/{id}.

get_bazel_build_step

ChatGPT

Recorded Bazel profile intervals with action outcomes and separately fetched sanitized logs when published by Bazel. IDs are opaque and scoped to the invocation. Profile times are milliseconds relative to the profile start; time filters select overlaps. Older builds fall back to bounded BEP summaries. Retention is 90 days.

get_bazel_cache_event

ChatGPT

Get one raw Bazel remote-cache observation.

get_bazel_integration_guide

ChatGPT

Return the workflow for connecting an existing Bazel project to Tuist. Use when the user asks to connect, configure, or debug that build. Covers project creation, authentication, setup, and verification.

get_bazel_invocation

ChatGPT

Get a completed Bazel invocation with custom metadata, build metrics, bounded timeline and critical-path diagnostics, and correlated remote-cache totals.

get_bazel_invocation_log

ChatGPT

Get one sanitized log captured for a Bazel invocation.

get_build_entity

ChatGPT

Get one build entity by the stable ID a list call returned, with its native identity and analytics for the chosen period. Kinds: gradle_tasks (Gradle tasks; history lists task executions), xcode_modules (generated Xcode project modules; history lists module cache events), once_actions (Once actions identified by declared target, capability and action index; history lists executions), mix_files (Mix compiled files; history lists compilations) and mix_modules (Mix compiled modules; durations measure the containing file's compilation, not independently measured module work). A kind is only available for projects using its build toolchain.

get_bundle

ChatGPT

Get detailed information about a specific bundle. Use get_bundle_artifact_tree to get the full artifact list. The bundle_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/bundles/{id}.

get_bundle_artifact_tree

ChatGPT

Get the full artifact tree for a bundle as a flat list sorted by path. The bundle_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/bundles/{id}.

get_cache_run

ChatGPT

Get detailed information about a specific cache run. The cache_run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/runs/{id}.

get_generation

ChatGPT

Get detailed information about a specific generation run. The generation_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/runs/{id}.

get_gradle_build

ChatGPT

Get detailed information about a specific Gradle build run. The build_run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/gradle/builds/{id}.

get_gradle_build_step

ChatGPT

Get recorded Gradle build steps. IDs are opaque and scoped to the build. Logs are not collected. Gradle includes timed tasks, configuration and transforms; legacy reports use the first recorded timestamp as origin. Times are milliseconds; time filters select overlaps and end_ms is exclusive. Retention is 90 days.

get_gradle_integration_guide

ChatGPT

Return the workflow for integrating an existing Gradle or Android build with Tuist. Use when the user asks to speed up, optimize, or connect that build. Covers authentication, project creation, plugin setup, cache policy, and proof.

get_latest_preview

ChatGPT

Given the binary ID and build version of a running app, get the latest preview on the same track (same bundle identifier and git branch). Returns null when no matching build is known. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

get_organization

ChatGPT

Get an organization's members, ordered by handle. Pending invitations, newest first, are included only when the caller has the same administrator permission as the dashboard's Invitations tab. Invitation acceptance tokens are never returned. Members and invitations are paginated with the same page and page_size; each list has its own pagination metadata.

get_preview

ChatGPT

Get detailed information about a specific preview, including temporary download URLs for its builds, valid for 60 minutes. The preview_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/previews/{id}.

get_project

ChatGPT

Get a project's dashboard configuration. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

get_runner_job

ChatGPT

Get a CI runner job for an account.

get_runner_volume

ChatGPT

Get volume repository, provider, platform, capacity, used space and last use.

get_runner_volume_analytics

ChatGPT

Get range-based storage, hit rate, job runs and trends for an account or volume. Defaults to the last seven days; maximum range is 90 days. Unknown metrics remain null.

get_test_case

ChatGPT

Get detailed information about a test case including reliability and flakiness metrics. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

get_test_case_run

ChatGPT

Get detailed information about a specific test case run including failures and repetitions. Use list_test_case_run_attachments to inspect attachments.

get_test_run

ChatGPT

Get detailed metrics for a specific test run, including temporary download URLs (valid for 15 minutes) for its result bundle — the .xcresult holding the failure details, attachments and timings Xcode recorded — and its session archive. Those URLs are presigned and not checked for existence: a run whose artifacts were never uploaded, or have since been pruned, answers 404 on download.

get_webhook_delivery_attempt

ChatGPT

Get a webhook delivery attempt for an endpoint.

get_webhook_endpoint

ChatGPT

Get a webhook endpoint for an account.

get_xcode_build

ChatGPT

Get detailed information about a specific build run, including a temporary download URL (valid for 15 minutes) for the archive it was processed from — a zip holding the raw .xcactivitylog, CAS metadata and machine metrics — for when the processed targets, files and issues are not enough. That URL is presigned and not checked for existence: a build whose archive was never uploaded, or has since been pruned, answers 404 on download. The build_run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/builds/build-runs/{id}.

get_xcode_build_step

ChatGPT

Get a recorded Xcode build step and its log. Logs retain up to 64 KiB per step; log_truncated indicates omitted output. Steps and logs expire after 90 days. An empty log means no output was recorded.

invite_organization_member

ChatGPT

Invite someone to an organization by email, whether or not they already have a Tuist account. Tuist emails them a link to accept the invitation, which expires after 14 days. When email_sent is false, the server cannot send email and the invitation link must be copied from the organization's Members page in the dashboard. Invitation acceptance tokens are never returned.

list_account_tokens

ChatGPT

List account tokens without exposing their secret values.

list_accounts

ChatGPT

List personal and organization account handles available to the authenticated user. Use when the account handle for a project is unknown.

list_automation_alert_revisions

ChatGPT

List an automation alert's revision history.

list_automation_alerts

ChatGPT

List automation alerts for a project. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

list_bazel_build_steps

ChatGPT

list_bazel_cache_events

ChatGPT

List the raw Bazel remote-cache observations for a project.

list_bazel_invocation_logs

ChatGPT

List the sanitized logs captured for a Bazel invocation in execution order.

list_bazel_invocations

ChatGPT

List Bazel invocations with custom metadata, build metrics, bounded timeline and critical-path diagnostics, and correlated remote-cache totals for a project.

list_build_entities

ChatGPT

List the tasks, modules, actions or files of one kind seen across a project's builds, with stable IDs independent of any run. Kinds: gradle_tasks (Gradle tasks; history lists task executions), xcode_modules (generated Xcode project modules; history lists module cache events), once_actions (Once actions identified by declared target, capability and action index; history lists executions), mix_files (Mix compiled files; history lists compilations) and mix_modules (Mix compiled modules; durations measure the containing file's compilation, not independently measured module work). A kind is only available for projects using its build toolchain.

list_build_entity_history

ChatGPT

List the recorded executions, compilations or cache events of one build entity, newest first, using the stable ID a list call returned. Kinds: gradle_tasks (Gradle tasks; history lists task executions), xcode_modules (generated Xcode project modules; history lists module cache events), once_actions (Once actions identified by declared target, capability and action index; history lists executions), mix_files (Mix compiled files; history lists compilations) and mix_modules (Mix compiled modules; durations measure the containing file's compilation, not independently measured module work). A kind is only available for projects using its build toolchain.

list_bundles

ChatGPT

List bundles (app binaries) for a project. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

list_cache_runs

ChatGPT

List cache runs for a project. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

list_generations

ChatGPT

List generation runs for a project. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

list_gradle_build_steps

ChatGPT

List recorded Gradle build steps. IDs are opaque and scoped to the build. Logs are not collected. Gradle includes timed tasks, configuration and transforms; legacy reports use the first recorded timestamp as origin. Times are milliseconds; time filters select overlaps and end_ms is exclusive. Retention is 90 days.

list_gradle_build_tasks

ChatGPT

List tasks for a specific Gradle build run. The project is derived from the build run, so no account or project handle is needed. The build_run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/gradle/builds/{id}.

list_gradle_builds

ChatGPT

List Gradle build runs for a project. Only available for projects with build_system=gradle. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

list_previews

ChatGPT

List previews (shareable app builds) for a project. Each preview includes temporary download URLs for its builds, valid for 60 minutes. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

list_project_notification_alerts

ChatGPT

List a project's notification alert rules. Webhook addresses are never returned.

list_project_tokens

ChatGPT

List project token metadata without exposing their secret values.

list_projects

ChatGPT

List all projects accessible to the authenticated subject.

list_runner_job_logs

ChatGPT

List captured log lines for a CI runner job.

list_runner_job_metrics

ChatGPT

List machine metrics recorded for a CI runner job.

list_runner_job_steps

ChatGPT

List the steps recorded for a CI runner job.

list_runner_job_volumes

ChatGPT

List the volumes mounted by a runner job.

list_runner_jobs

ChatGPT

List CI runner jobs for an account.

list_runner_profiles

ChatGPT

List CI runner profiles for an account.

list_runner_volume_jobs

ChatGPT

List volume job history. Cache status describes saving changes, not the job result.

list_runner_volumes

ChatGPT

List and sort runner volumes for an account. Optional name and repository filters match exactly and combine with AND.

list_runner_workflows

ChatGPT

List CI runner workflows for an account.

list_test_case_events

ChatGPT

List events for a test case (e.g. marked_flaky, muted, skipped, first_run). The test_case_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account_handle}/{project_handle}/tests/test-cases/{test_case_id}.

list_test_case_run_attachments

ChatGPT

List attachments for a test case run. Each attachment includes a temporary download URL (valid for 1 hour).

list_test_case_runs

ChatGPT

List test case runs, optionally filtered by test case or test run. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

list_test_cases

ChatGPT

List test cases for a project. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

list_test_module_runs

ChatGPT

List test module runs for a specific test run. The test_run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/tests/test-runs/{id}.

list_test_runs

ChatGPT

List test runs for a project. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

list_test_suite_runs

ChatGPT

List test suite runs for a specific test run, optionally filtered by module. The test_run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/tests/test-runs/{id}.

list_tuist_files

ChatGPT

Use this when the relevant Tuist source path is unknown and you need to discover a subsystem or nearby tests. List a narrow repository-relative path to avoid broad repository enumeration. The listing covers a fixed source revision with bounded depth, traversal, time, and output. A truncated response is partial; narrow the path or file_glob and list again.

list_webhook_delivery_attempts

ChatGPT

List webhook delivery attempts for an endpoint.

list_webhook_endpoints

ChatGPT

List webhook endpoints for an account.

list_xcode_build_cache_tasks

ChatGPT

List cacheable tasks (cache hits/misses) for a specific Xcode build run. Only available for projects with build_system=xcode. The build_run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/builds/build-runs/{id}.

list_xcode_build_cas_outputs

ChatGPT

List content-addressable storage outputs for a specific Xcode build run. Only available for projects with build_system=xcode. The build_run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/builds/build-runs/{id}.

list_xcode_build_files

ChatGPT

List compiled files for a specific Xcode build run. Only available for projects with build_system=xcode. The build_run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/builds/build-runs/{id}.

list_xcode_build_issues

ChatGPT

List build issues (warnings and errors) for a specific Xcode build run. The build_run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/builds/build-runs/{id}.

list_xcode_build_steps

ChatGPT

List recorded Xcode build steps without logs. Page size defaults to 20 (max 100). Times are milliseconds from build start; time filters select overlaps with an exclusive end_ms. Steps expire after 90 days; unavailable means not recorded or expired. Use get_xcode_build_step to inspect a log.

list_xcode_build_targets

ChatGPT

List build targets for a specific Xcode build run. Only available for projects with build_system=xcode. The project is derived from the build run, so no account or project handle is needed. The build_run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/builds/build-runs/{id}.

list_xcode_builds

ChatGPT

List Xcode build runs for a project. Only available for projects with build_system=xcode. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

list_xcode_module_cache_targets

ChatGPT

List module cache targets for a generation or cache run, showing per-target cache hit/miss status and subhashes. Only available for projects with build_system=xcode. The run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/runs/{id}.

list_xcode_test_targets

ChatGPT

List Xcode test targets with their selective testing status (hit/miss) and hash for a given test run. The test_run_id can also be a Tuist dashboard URL, e.g. https://tuist.dev/{account}/{project}/tests/test-runs/{id}.

read_tuist_file

ChatGPT

Read a bounded line range from a fixed Tuist source revision. Use when the relevant source path is known and you need to inspect an implementation file, call site, or focused test. When truncated, continue from next_start_line rather than increasing the limit.

search_tuist

ChatGPT

Search public Tuist documentation, the application programming interface reference, release notes, community discussions, and issues. Use when the user asks about documented behavior, released changes, terminology, or known issues. Returns matching excerpts and source links.

search_tuist_code

ChatGPT

Search a fixed revision of public Tuist source code for implementation details. Use when the user asks about current command behavior, defaults, configuration, feature gates, error handling, or behavior not covered by public documentation. Search literal identifiers, command names, configuration keys, or error messages. Results have bounded traversal, input, time, and output; narrow the path or file_glob when a response is truncated.

start_project_logo_upload

ChatGPT

Start a project-logo upload. Returns a presigned URL the client PUTs the image bytes to (within one hour), the request method and Content-Type header to use, and an upload_token. After PUT completes, call complete_project_logo_upload with the same account/project handles and the upload_token to commit the new logo. Accepted MIME types: image/png, image/jpeg, image/webp; files must be 2 MB or smaller.

update_test_case

ChatGPT

Update mutable fields on a test case. Supports changing state between enabled, muted, and skipped, and toggling is_flaky. A change can dispatch a test-case event to webhook endpoints configured by the account, including external services. The account_handle and project_handle can be extracted from a Tuist dashboard URL: https://tuist.dev/{account_handle}/{project_handle}.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Links

Documentation ↗Privacy Policy ↗

App Stats

Tools

Prompts

ChatGPT

Platforms