> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trybrein.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync

> Un resumen opcional, para todo el equipo, de lo que drifteó alrededor de tus topics.

`driftless sync` es un resumen **opcional** para todo el equipo. Casi nunca lo necesitas, y nunca para empezar. El drift ya te llega como un badge de frescura cuando haces `driftless context get` sobre el área en la que trabajas. Recurre a `sync` solo cuando quieras revisar de una vez todo lo que se movió.

No inspecciona tu diff local y no recupera contexto específico de archivos. Trae el estado de memoria del repo desde Driftless Cloud y responde una sola pregunta:

> ¿Qué cambió alrededor de los topics de este repo desde la última vez que miré?

## Comando

| Comando | Flags    | Descripción                                         | Ejemplo          |
| ------- | -------- | --------------------------------------------------- | ---------------- |
| `sync`  | `--json` | Muestra topics stale persistidos y topics sugeridos | `driftless sync` |

```bash theme={"theme":"github-light"}
driftless sync
```

Salida típica:

```text theme={"theme":"github-light"}
▌ acme/platform
  workspace: acme  (resolved via config)
⚠  2 topics drifted, the team changed code these topics cover, context may be behind:
   auth-boundaries
     src/auth/session.ts changed
     → review the change; if it changed how this works: driftless context update auth-boundaries --what "..." --how "..."
```

## Qué revisa sync

| Señal                | Fuente                                        | Qué hacer                                                                    |
| -------------------- | --------------------------------------------- | ---------------------------------------------------------------------------- |
| **Topics stale**     | `context get --diff --mark` local y explícito | Revisa el código que cambió y actualiza el topic si cambió el comportamiento |
| **Topics sugeridos** | Sugerencias pendientes                        | Revisa y confirma el contexto útil                                           |

## Cuándo usar sync

El loop de cada día no necesita `sync`. Ve directo a la recuperación, que lleva el badge de frescura incorporado:

```bash theme={"theme":"github-light"}
driftless context get --files "src/auth/session.ts,src/auth/token.ts"
```

Recurre a `sync` solo cuando quieras la foto completa de todo el equipo de una sola vez:

```bash theme={"theme":"github-light"}
driftless sync
```

Si ya tienes cambios locales y quieres los topics que coinciden con el diff:

```bash theme={"theme":"github-light"}
driftless context get --diff
```

## Salida JSON

Usa `--json` cuando un agente o un script necesite salida estructurada:

```bash theme={"theme":"github-light"}
driftless sync --json
```

La salida JSON incluye:

| Campo               | Significado                                               |
| ------------------- | --------------------------------------------------------- |
| `repo`              | Identidad del repositorio resuelta desde el remote actual |
| `workspace`         | Slug del workspace de Driftless                           |
| `stale_topics`      | Topics cuyo código anclado cambió                         |
| `suggested_pending` | Número de topics sugeridos pendientes de revisión         |