# Sentiary documentation

> Get started with Sentiary 2.0: CLI, MCP, configuration, Gradle, and API guides

Sentiary manages localization terms and translations. Use the CLI to download translations,
configure projects and outputs in TOML, or integrate generated resources into Gradle builds.

The sections below cover getting started, the complete CLI, configuration and offline use,
Gradle integration, API authentication, and migration and troubleshooting.
For the complete REST API schema, use [OpenAPI](api/openapi.yaml).

## Get started

- [Overview](<https://docs.sentiary.com/index.md>): Overview of Sentiary and its documentation.
- [Installation](<https://docs.sentiary.com/getting-started/installation/index.md>): Install, verify, and upgrade the CLI on macOS, Linux, and Windows.
- [First download](<https://docs.sentiary.com/getting-started/quickstart/index.md>): Configure credentials and download your first translations.

## CLI

- [Command reference](<https://docs.sentiary.com/cli/reference/index.md>): Complete command and flag reference, defaults, and examples.
- [Android, Compose, and Xcode](<https://docs.sentiary.com/cli/mobile/index.md>): Android, Compose Multiplatform, and Xcode examples.

## Configuration and offline use

- [TOML reference](<https://docs.sentiary.com/configuration/reference/index.md>): Every TOML field, supported format, and validation rule.
- [Languages and multiple projects](<https://docs.sentiary.com/configuration/languages/index.md>): Language selection, locale mappings, aliases, and multiple projects.
- [Downloads and offline use](<https://docs.sentiary.com/configuration/downloads/index.md>): Download ownership, caching, offline use, and failure recovery.

## Gradle

- [Setup and reference](<https://docs.sentiary.com/gradle/index.md>): Plugin setup, every settings field and property, tasks, and requirements.
- [Android and Compose builds](<https://docs.sentiary.com/gradle/guides/index.md>): Android and Compose resource integration and CI examples.

## API

- [Overview and authentication](<https://docs.sentiary.com/api/index.md>): REST API overview, authentication, and the authoritative OpenAPI schema.

## Migration and troubleshooting

- [Migration from 1.x](<https://docs.sentiary.com/migration/index.md>): Migrate from Gradle plugin 1.x to CLI and Gradle 2.0.
- [Troubleshooting](<https://docs.sentiary.com/troubleshooting/index.md>): Diagnose installation, configuration, download, and build failures.

## MCP and integration

- [Hosted service and tools](<https://docs.sentiary.com/mcp/index.md>): Hosted MCP authentication, deployment, and complete tool inventory.
- [CLI protocol](<https://docs.sentiary.com/integration/protocol/index.md>): CLI handshake, request, result, and preview contracts.
- [Download internals](<https://docs.sentiary.com/configuration/internals/index.md>): Download concurrency, conditional requests, and cache identity.