agentic.nvim: Skill for Claude Code

Agentic UI Message Writer

This skill covers chat-buffer content state. For widget windows, layout, fallback windows, hidden floats, and buffer redirection, read lua/agentic/ui/AGENTS.md first.

Hard rules

• wrap stays on.
• Cursor positioning is G0zb, not G$zb.
• Cursor sits on the trailing "" line below the last block, never inside a tool-call block.
• scrolloff = 4 on chat keeps room for spinner virt_lines above the cursor.
• Auto-scroll captures before mutation and applies after mutation in the same tick. No vim.schedule between them.
• Tool-call body updates replace only the body between stable anchor pads.
• Manual folds only. Never foldexpr; read ADR 0001 before proposing foldexpr workarounds.
• tracker.rendered_button_count is render-path-only state.

Tool-call layout

row 0          header         rewritten on every update, NOT folded
row 1          "" top_pad     fold start anchor
row 2..M-1     body           replaced on every update
row M          "" bottom_pad  fold end anchor
row M+1..M+K   permission     K rows: N button rows + N empty spacer rows
row M+K+1      status row     real text, outside the fold

• K = 2 * N for N permission options.
• Permission rows are outside the fold.
• MessageWriter:_render_permission_section owns all permission rows plus the status row.
• Pads are unconditional.
• Header is rewritten because providers send placeholder titles before final titles.

Permission rows

• Buttons live one-per-row between bottom_pad and the status row.
• Empty spacer rows sit between buttons, with one trailing spacer above the status row.
• Digit keymaps are bound only while a block is focused.
• Cycle keys and <CR> are row-gated to button rows or the focused block's status row.
• Spacer rows fall through to default motion.
• Focus transition repaints old and new status rows.

Regression anchors:

• permission_manager.test.lua::digit keymap lifecycle::"rebinds digit keymaps with new mapping after focus transition"
• permission_manager.test.lua::bracket cycle::"focus transition triggers exactly 2 status-row repaints"