Common workflows

Task-shaped recipes. Concepts: Policy, Audit. Linear tour: Quickstart.

First governed session

1. Start and check

   carina daemon start   # optional if you only use interactive carina
   carina doctor

2. Run in a repo

   cd /path/to/your/repo
   carina run "Summarize the top-level layout of this repository"

3. Verify the trail

   carina sessions
   carina audit SESSION
   carina audit verify SESSION

Fix a failing test

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

carina patch list SESSION
carina patch rollback SESSION PATCH_ID
carina audit verify SESSION

Inspect what the agent did

carina audit SESSION
carina report SESSION
carina items SESSION
carina audit verify SESSION

Run the review workflow

mkdir -p .carina/workflows
cp examples/workflows/review.json .carina/workflows/
carina workflow run review

Embed / script

Open Method catalog → expand a method → Playground → Mock for a response shape without a daemon.

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

carina gateway methods   # list methods when gateway/daemon is up

Source of truth

• Recipes on this page · CLI: carina --help · CLI reference
• Security defaults: Policy · Audit
• Embed path: Method catalog · Sessions

Next

Need	Page
Install	Install
Full CLI	CLI reference
Why approvals	Policy

Tip

Golden path: doctor → run → audit verify → patch rollback