← Every tool · Open in the full app · Get the app

Chevron Lists

Interactive reference for the VS Code extension - syntax, commands, and examples

🏷️ Syntax

The pattern is simple: one › means a section header, two ›› means an item.

> My Section >> - An item >>> - Nested

🏗️ Core Structure

  • Section Header > Name

    Top-level section. Everything beneath it belongs to this section.

    > Sprint Goals
  • Bullet Item >> - Content

    Standard list item at depth 1. The default building block.

    >> - Fix the login bug
  • Numbered Item >> 1. Content

    Numbered step. Enter auto-increments. Tab promotes depth.

    >> 1. Install dependencies
  • Nested Item >>> - Content

    Deeper nesting - any number of > characters above two works.

    >>> - Check edge cases too
  • Group Divider >> -- Name

    Named group divider within a section. Renders as a subtle separator.

    >> -- Backend Tasks

⚡ Task & Priority

  • Checkbox >> - [ ] Task

    Unchecked task. Toggle with CL: Toggle Item Done or click the gutter icon.

    >> - [ ] Write the tests
  • Done >> - [x] Task

    Completed task. Auto-archived if chevron-lists.autoArchive is on.

    >> - [x] Deploy to staging
  • Low Priority >> - ! Content

    Low priority - yellow background tint on the item line.

    >> - ! Update the README
  • Medium Priority >> - !! Content

    Medium priority - amber background. Ruler marker added.

    >> - !! Fix the flaky test
  • Urgent >> - !!! Content

    Urgent - red background. Two or more in a section tint the gutter red.

    >> - !!! Production is down
  • Question Flag >> - ? Content

    Marks an item as a question or uncertainty needing resolution.

    >> - ? Is this the right API?
  • Star Marker >> - * Content

    Marks a key deliverable or highlight. Filterable with CL: Filter Starred Items.

    >> - * Ship v2 this week

🏷️ Metadata

  • Tag #tag

    Attach tags to items. Autocompleted from tags in the file.

    >> - Fix auth bug #backend #urgent
  • Due Date @YYYY-MM-DD

    Due date. Overdue items appear in status bar and Today View.

    >> - Submit report @2026-04-15
  • Mention @Name

    Assign to a person. All mentions appear in the Mentions Report.

    >> - Review PR @Alice
  • Recurring @daily / @weekly

    Recurring item. Appears in CL: Show Recurring Items.

    >> - Team standup @daily
  • Time Estimate ~2h / ~30m

    Time estimate. CL: Show Section Time Estimate sums all estimates.

    >> - Refactor service ~3h
  • Vote Count +N

    Vote score. Sort by votes with CL: Sort by Votes.

    >> - Use Postgres instead +7
  • Rating ★N

    Star rating 1-5. Filter with CL: Filter by Rating.

    >> - ★4 Good candidate
  • Creation Date @created:date

    Creation stamp. Items 30+ days old render muted and italic.

    >> - Old idea @created:2026-01-01
  • Expiry @expires:date

    Expiry date. Expired items appear in Problems panel.

    >> - Limited offer @expires:2026-12-31

🎨 Visual Labels

  • Colour Label {colour}

    Colour-coded label. Options: red green blue yellow orange purple.

    >> - {red} Blocked on infra
  • Square Label [LABEL]

    Custom square-bracket label, rendered in gold.

    >> - [ACTION] Chase the invoice
  • Inline Comment // note

    Inline comment rendered muted after the main item content.

    >> - Deploy // check DNS first
  • Strikethrough ~~text~~

    Struck-through text - visually cancelled but still present.

    >> - ~~Old approach, replaced~~
  • Section Colour [colour:X]

    Colours the section header itself. Set on the > Header line.

    > Research [colour:blue]
  • Word Goal ==N

    Word count goal on a section. Renders as a live progress bar.

    > Chapter One ==1500

🔗 Links & Notes

  • Section Link [[Section Name]]

    Links to another section. Hover shows a preview of its top items.

    >> - See [[Act Two]] for context
  • Inline Note >> > Note text

    A note line attached to the section, rendered subtly below items.

    >> > Last updated 2026-03-31
  • Bookmark [bookmark:Name]

    Named bookmark in the section. Jump with CL: Jump to Bookmark.

    >> [bookmark:Key Scene]

⌨️ Commands

All commands available via Ctrl+Shift+P then type CL: in VS Code

🧭 Navigation

  • Next / Previous Header Jump between section headersCtrl+Alt+↓ / ↑
  • CL: Filter Sections Fuzzy-search jump to any section
  • CL: Filter Sections (Workspace) Same, across all workspace files
  • CL: Jump Back Return to previous cursor position
  • CL: Focus on Section Fold all other sections
  • CL: Unfocus Section Restore all folded sections
  • CL: Jump to Bookmark Quick pick from all [bookmark:] markers

🔍 Search & Filter

  • CL: Search Items Live search across all items
  • CL: Filter by Tag Filter items by #tag
  • CL: Filter by Multiple Tags Multi-tag AND/OR filter
  • CL: Filter by Priority Filter by ! / !! / !!!
  • CL: Filter by Mention Filter by @PersonName
  • CL: Filter by Colour Label Quick pick by {colour} label
  • CL: Filter by Rating Items at or above chosen ★N
  • CL: Today View All overdue and due-today items
  • CL: Show Upcoming Due Dates @date items sorted chronologically
  • CL: Show Old Items (30+ days) Items with @created: older than 30 days

📂 Section Actions

  • CL: New Section Prompt for name, insert header + item
  • CL: Rename Section Rename header + update all [[links]]
  • CL: Delete Section Delete header and all items
  • CL: Move Section Up/Down Swap with neighbour section
  • CL: Merge Section Below Combine with section below
  • CL: Split Section Here Split at cursor into two sections
  • CL: Diff Two Sections Side-panel line diff of any two sections
  • CL: Archive Done Items Move [x] items to an Archive section
  • CL: Sort by Due Date Sort items by @date ascending
  • CL: Show Section Time Estimate Sum of all ~estimate markers

✏️ Item Actions

  • CL: Toggle Item Done Toggle [ ] ↔ [x]
  • CL: Toggle Star Toggle * star marker
  • CL: Toggle Flag Toggle ? question flag
  • CL: Add Vote Increment +N vote count
  • CL: Move Item to Section Move to another section
  • CL: Smart Paste Paste as chevron items, auto-detects format
  • CL: Edit Item Content Input box - markers hidden, preserved on save
  • CL: Evaluate Expression in Item Evaluates =expr inline
  • CL: Start/Stop Item Timer Elapsed timer stamped on stop
  • CL: Send to Daily Note Copy item to today's Inbox section

⚡ Bulk Actions

  • CL: Mark All Done (Section) Bulk [x] all items in section
  • CL: Bulk Tag Items Add #tag to every section item
  • CL: Bulk Set Priority Set priority on every item
  • CL: Bulk Set Due Date Set @date on every item
  • CL: Shift All Due Dates Shift every @date by ±N days
  • CL: Clear All Priority Remove all ! markers from section
  • CL: Sort Items A to Z Alphabetical sort
  • CL: Sort Items by Votes Sort by +N descending
  • CL: Batch Replace Text Find/replace in section with preview

📊 Views & Export

  • CL: Show Kanban Items grouped as Todo / In Progress / Done
  • CL: Show File Statistics Full file stats webview
  • CL: Show Tag Stats Tag completion % webview
  • CL: Show Mentions Report @Name assignment table
  • CL: Show Section Growth Bar chart of item count per section
  • CL: Export File as HTML Export full file as HTML/JSON/CSV/Markdown
  • CL: Colour Theme Choose from 13 colour presets

🤖 AI Assist

  • CL: Suggest Items (AI) Claude suggests 3-5 items for the section
  • CL: Summarise Section (AI) One-line summary as first item
  • CL: Expand Item (AI) Expand item into sub-items
  • CL: Rewrite Item (AI) Rewrite for clarity, markers preserved

💡 Examples

Sprint Board

A two-week sprint tracked entirely in Chevron Lists - priorities, owners, estimates.

> Sprint 14 [colour:blue]>> -- Backend>> - !!! Fix auth token expiry bug #backend @Alice @2026-04-05 ~2h>> - !! Add rate limiting to /api/messages #backend ~3h>> - [ ] Write migration for new users table ~1h30m>> -- Frontend>> - !! [REVIEW] Update login page UI @Bob ~2h>> - [ ] Dark mode toggle #ui +5>> - ~~Old approach with iframes~~ // replaced with component>> -- Done>> - [x] Set up CI pipeline @Alice>> - [x] Upgrade to .NET 9

Novel Outline

Tracking a novel with word goals, scene cards, and priorities.

> Act One - The Setup ==8000 [colour:purple]>> 1. ★4 Introduce Mara in the market - busy, chaotic>> 2. The stranger with the wrong accent>> 3. !!! Night of the missing shipment #plot-critical>> -- Notes>> > Mara should feel capable but out of her depth> Act Two - Complications ==15000>> 1. [ ] The warehouse confrontation ~3h>> 2. [ ] ? Who tipped off the guards? // needs resolution>> 3. [ ] !! Mara finds the ledger @2026-04-20> Research>> - Merchant guild structures in 14th century Bruges>> - Ship manifest formats [[Act One]] for reference

Daily Notes

A personal daily note with tasks, captures, and time-blocking.

> Thursday 3 April 2026>> -- Morning>> - [x] Team standup @daily>> - [x] Review PR from @Oscar>> - !! Reply to client email #urgent @2026-04-03>> -- Afternoon>> - [ ] Finish PathWars client UI ~3h>> - [ ] Deploy to VPS>> - [ ] ? Should we add a dark mode toggle? +3>> -- Inbox>> - ★ Chevron Lists tool idea - reference explorer>> - AI autocomplete for item content - raise as feature>> > Captured from standup

Combining Markers

One item demonstrating every marker working together.

> Power User Showcase>> - !!! [x] Fix critical auth bug #backend #security @Alice @2026-04-01 ~2h +8 ★5 // highest priority this sprint>> -- What each marker does above>> - !!! = urgent (red background)>> - [x] = completed checkbox>> - #backend #security = two tags>> - @Alice = assigned to Alice>> - @2026-04-01 = due date>> - ~2h = two hour estimate>> - +8 = eight upvotes>> - ★5 = five-star rating>> - // = inline comment (rendered muted)

How it works

Chevron Lists is an extension for VS Code that turns plain lines into sections and items. A line that starts with one chevron is a section header, a line with two is an item in it, and three or more nest the item deeper. Markers inside a line add checkboxes, priorities, tags, due dates, people, estimates, votes and labels, and the extension highlights, folds, filters and reports on them.

Open the Syntax tab for every marker with an example, the Commands tab to search the main commands (press Ctrl+Shift+P in VS Code and type CL: to run one), and the Examples tab for whole files that put the markers together. The same reference is in the Chevron Lists tool in the app.