---
title: "Common workflows"
description: "Short recipes aligned with the live CLI — first session, fix tests, audit, rollback, embed."
source: https://carina.nebutra.com/getting-started/common-workflows/
---

# Common workflows

> Short recipes aligned with the live CLI — first session, fix tests, audit, rollback, embed.

Task-shaped recipes. Concepts: [Policy](/concepts/policy/), [Audit](/concepts/audit/). Linear tour: [Quickstart](/getting-started/quickstart/).

## First governed session

    ```bash frame="none"
    carina daemon start   # optional if you only use interactive carina
    carina doctor
    ```

    ```bash frame="none"
    cd /path/to/your/repo
    carina run "Summarize the top-level layout of this repository"
    ```

    ```bash frame="none"
    carina sessions
    carina audit SESSION
    carina audit verify SESSION
    ```

## Fix a failing test

```bash frame="none"
carina run "fix the failing test in parser.go and run the test"
```

Approvals may appear for risk ≥ 2 commands — expected under `safe-edit`.

## Roll back a bad patch

```bash frame="none"
carina patch list SESSION
carina patch rollback SESSION PATCH_ID
carina audit verify SESSION
```

## Inspect what the agent did

```bash frame="none"
carina audit SESSION
carina report SESSION
carina items SESSION
carina audit verify SESSION
```

## Run the review workflow

```bash frame="none"
mkdir -p .carina/workflows
cp examples/workflows/review.json .carina/workflows/
carina workflow run review
```

## Embed / script

Open [Method catalog](/api/methods/) → expand a method → **Playground → Mock** for a response shape without a daemon.

For live JSON-RPC over the local socket, use the [Sessions API](/api/sessions/) samples or SDKs (`client.request("session.create", …)`).

```bash frame="none"
carina gateway methods   # list methods when gateway/daemon is up
```

## Source of truth

- Recipes on this page · CLI: `carina --help` · [CLI reference](/reference/cli/)
- Security defaults: [Policy](/concepts/policy/) · [Audit](/concepts/audit/)
- Embed path: [Method catalog](/api/methods/) · [Sessions](/api/sessions/)

## Next

| Need | Page |
| --- | --- |
| Install | [Install](/getting-started/installation/) |
| Full CLI | [CLI reference](/reference/cli/) |
| Why approvals | [Policy](/concepts/policy/) |

  Golden path: <Badge variant="accent">doctor → run → audit verify → patch rollback</Badge>

---
Source: https://carina.nebutra.com/getting-started/common-workflows/
Markdown: https://carina.nebutra.com/getting-started/common-workflows/index.md