NOMOS Agent ToolkitBuild, run, and debug NOMOS agents without leaving VS Code. Features
|
| Prefix | Component |
|---|---|
nomos-column |
Vertical layout container |
nomos-row |
Horizontal layout container |
nomos-section |
Titled collapsible section |
nomos-card |
Card with optional header/footer |
nomos-text |
Text with variant (heading, body, code, …) |
nomos-badge |
Colored status badge |
nomos-alert |
Alert box (info / success / error / warning) |
nomos-divider |
Horizontal divider |
nomos-stat |
Statistic with optional trend delta |
nomos-table |
Data table |
nomos-chart-bar |
Bar chart |
nomos-chart-line |
Line chart |
nomos-list |
Bullet or ordered list |
nomos-progress |
Progress bar |
nomos-button |
Interactive button with callback_tool |
nomos-button-group |
Inline group of buttons |
nomos-response |
Full NomosResponse + NomosUI scaffold |
@tool Diagnostics
The extension checks every @tool-decorated function and warns when:
- The docstring is missing entirely
- A parameter is not documented with
:param name: - The
:returns:entry is absent
Warnings appear inline as yellow squiggles and in the Problems panel.
Trace Viewer
Run NOMOS: Start Agent from the Command Palette (Ctrl+Shift+P). A split panel opens showing a live event timeline — turn_start, llm_end, tool_call, cost_ceiling_warning, and all other @@TRACE@@ events — color-coded and filterable. Click any event to expand the full JSON payload.
Hot-Reload
While an agent is running, any .py file save triggers a 500ms-debounced agent restart. The status bar item updates:
⊘ NOMOS: Idle— no agent running◉ NOMOS: Live— agent running, watching for changes↻ NOMOS: Reloading…— file changed, restarting
Requirements
- VS Code 1.85+
- Python 3.10+ with the NOMOS SDK installed (
pip install nomos-sdk)
Extension Settings
| Setting | Default | Description |
|---|---|---|
nomos.pythonPath |
python |
Python interpreter to use (can be a virtualenv path) |
nomos.agentEntryPoint |
agent.py |
Entry file to run when starting the agent |
Commands
| Command | Description |
|---|---|
NOMOS: Start Agent |
Starts the agent and opens the trace viewer |
NOMOS: Stop Agent |
Terminates the running agent |
NOMOS: Open Trace Viewer |
Opens the trace event timeline panel |
NOMOS: Validate Manifest |
Opens manifest.json with inline schema validation |
Quick Start
- Open a NOMOS agent directory in VS Code
- The extension activates automatically (workspace contains
manifest.json) - Open
manifest.json— IntelliSense is active immediately - Type
nomos-cardinagent.pyand press Tab - Press
Ctrl+Shift+P→ NOMOS: Start Agent to run and trace your agent
License
MIT