get_state_brief
Retrieve a lightweight, read-only snapshot of the current Neovim session to see mode, working directory, open/modified buffers, active window, and cursor context before reading or editing files.
Instructions
Lightweight snapshot of the Neovim session for quick orientation. Read-only — does not modify any editor state.
Use this when a turn depends on what the user is working on:
before reading or editing files, acting on the editor, or
answering about the current view. One call per turn is enough;
skip it for turns that don't touch the editor or files. Use
get_state instead when you need the full picture: all windows,
folds, marks, diagnostics summaries, highlights, virtual text, and
indent settings.
Returns: mode (normal/insert/visual/etc.), cwd, buffers (relative paths of all listed buffers), modified_buffers, and active_window: {file, filetype, total_lines, modified, buftype, line, col, context}. context is a short list of numbered lines around the cursor.
If an alternate window exists, also returns alternate_window with
the same fields. When terminal buffers exist, returns terminals — a
list of {buf, name, visible} (targets for send_to_terminal).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||