---
id: TASK-2.2
title: Document `profiles` command
status: Done
assignee:
  - codex
created_date: '2026-01-29 18:16'
updated_date: '2026-01-29 18:26'
labels: []
dependencies: []
references:
  - README.md
  - lua/zync/api.lua
parent_task_id: TASK-2
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Update README/CLI docs to describe the new `profiles`/`p` command, expected output, and the profile-less message behavior.
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [x] #1 README includes `profiles` command in the command list/table with shorthand `p`
- [x] #2 Documentation mentions output order and the message shown when profiles are not configured
- [x] #3 Any CLI usage examples include the new command where appropriate
- [x] #4 Docs remain consistent with existing style and formatting
<!-- AC:END -->

## Implementation Plan

<!-- SECTION:PLAN:BEGIN -->
1) Find the command list/table in `README.md` and add `profiles, p` with a short description.
2) Add a short note about deterministic order (zconf definition order) and the profile‑less message text.
3) Add a brief usage example if there’s a commands section (keep consistent with existing style).
4) Confirm README formatting stays consistent.
<!-- SECTION:PLAN:END -->

## Implementation Notes

<!-- SECTION:NOTES:BEGIN -->
Documented `profiles, p` command in README usage/commands sections and described profile-less message text and ordering (`README.md`).
<!-- SECTION:NOTES:END -->
