Agent skill

Nodetool Chat CLI

by nodetool-ai in nodetool-ai/nodetool

Use NodeTool chat CLI sessions, provider selection, workspace tools, and Global Chat features.

AGPL-3.0Auto-check passedAI & LLM Engineering

Install Nodetool Chat CLI

skills CLI
$ npx skills add nodetool-ai/nodetool --skill nodetool-chat-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nodetool-ai/nodetool nodetool-chat-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/system-skills/nodetool-chat-cli .claude/skills/nodetool-chat-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nodetool-chat-cli
GitHub stars
556
Token cost
~1.8k tokens
SKILL.md length
721 words
Files
1
Skills in repo
127
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Use NodeTool chat CLI sessions, provider selection, workspace tools, and Global Chat features.

  • Works in 4 steps: Plan — break tasks into steps → Use tools — search, browse, file ops,… → Iterate — execute steps, evaluate… → …
  • AI & LLM Engineering work in your project
  • SKILL.md covers Starting Chat, CLI Flags, Slash Commands (prefix with /) and Configuration, plus 7 more sections
  • Calls curl and npm; needs OPENAI_API_KEY

What it does

Nodetool Chat CLI is an agent skill from nodetool-ai/nodetool. Use NodeTool chat CLI sessions, provider selection, workspace tools, and Global Chat features.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering. The repository describes itself as: Agent-first Creative Workspace. The licence is AGPL-3.0.

When your agent uses it

  • AI & LLM Engineering work in your project

Example prompts

  • “/nodetool-chat-cli”

Requirements

  • Python 3
  • A credential in OPENAI_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Plan — break tasks into steps
  2. Use tools — search, browse, file ops, code execution, media generation
  3. Iterate — execute steps, evaluate results, adapt
  4. Run workflows — trigger saved NodeTool workflows

What it can do on your machine

Read from SKILL.md and the folder at commit 515bd28. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl and npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OPENAI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nodetool Chat CLI loads about 1.8k tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 721 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~28
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nodetool-ai/nodetool at commit 515bd28, republished under its AGPL-3.0 licence (© nodetool-ai). 721 words, ~1,766 tokens.

Download SKILL.mdSave it as .claude/skills/nodetool-chat-cli/SKILL.md (or your agent's skills folder).
name
nodetool-chat-cli
description
Use NodeTool chat CLI sessions, provider selection, workspace tools, and Global Chat features.

You help users use NodeTool's chat interfaces — the terminal chat CLI and Global Chat.

Chat CLI

The chat CLI fills the terminal with a scrollable transcript, multiline composer, tool details, task progress, and approval prompts. Two entry points:

  • nodetool-chat (standalone binary)
  • nodetool chat (subcommand that forwards to the chat UI)

From source (no build): npm run dev:chat -- [flags].

Starting Chat

bash
# Interactive chat (default provider/model from saved settings)
nodetool chat

# With a specific provider/model
nodetool chat -p openai -m gpt-5.4
nodetool chat -p anthropic -m claude-sonnet-4-6
nodetool chat -p ollama -m qwen-3.5:4b

# Restrict the enabled tools
nodetool chat --tools google_search,browser,write_file

# Connect to a running server instead of a local provider
nodetool chat -u ws://localhost:7777/ws

Agent mode is always on. Every chat session runs the unified agent loop (planning + tools). The old -a/--agent and --no-agent flags are deprecated no-ops kept for compatibility.

CLI Flags

FlagPurpose
-p, --provider <name>LLM provider (see list below)
-m, --model <id>Model ID
-w, --workspace <path>Workspace directory (default: cwd)
--tools <list>Comma-separated enabled tools
-u, --url <ws-url>Connect to a NodeTool server WebSocket
--resume [id]Resume a saved session in this workspace, latest if no ID is given
`--permission-mode <defaultauto
--no-read-only-searchDisable the read-only run_search fan-out primitive
--trace-file <path>Append LLM/agent/workflow spans as JSONL
--trace-stdout [pretty|json]Stream spans to stdout

Providers: anthropic, claude_agent_sdk, openai, codex, gemini, xai, groq, mistral, deepseek, moonshot, minimax, cerebras, alibaba, gmi, together, openrouter, requesty, huggingface, replicate, kie, aki, ollama, lmstudio, mlx. Any other registered provider id (e.g. vllm) also works when passed explicitly.

Slash Commands (prefix with /)

CommandPurpose
/helpShow commands and keyboard shortcuts in the transcript
/newStart a fresh session (clears history + server thread)
/clearClear the visible history
/compactSummarize and compact the conversation context
/model [provider/id]Browse models from all configured providers, or switch with a provider/model ID
/agent [id|main]Browse sub-agent threads, inspect one, or return to the main conversation
/toolsList the enabled tools
`/mode <defaultauto
/sessionsBrowse saved conversations for this workspace and server
/resume [id]Resume a saved conversation
/export [path.md]Save a Markdown transcript without overwriting an existing file
/detailsToggle tool arguments, code, and edit diffs
/exit, /quitQuit chat

Enter sends. Alt+Enter, Shift+Enter in supported terminals, or Ctrl+J inserts a newline. Up/Down recalls prompts and Tab completes commands. Page Up/Page Down scrolls, Ctrl+G returns to the latest output, and Ctrl+O toggles tool details. Escape cancels a turn or dismisses input. Ctrl+C cancels, clears a draft, or saves and exits when idle with an empty composer. Approval prompts show their answer keys and can be scrolled before answering.

/compact summarizes local context. Connected servers manage their own context. /clear only clears the screen, while /new resets the conversation.

Non-slash input is sent to the model as a chat message — there is no built-in shell (ls, cd, …) in the chat prompt. File operations happen through the agent's file tools in the workspace.

Show full SKILL.md (284 more words)Show less

Configuration

  • Settings file: ~/.nodetool/chat-settings.json (persists provider + model)
  • Sessions: ~/.nodetool/chat-sessions/ (transcript, context, provider continuation)
  • Sessions are saved after turns and on exit. The picker filters by workspace and server. Resuming does not carry over approval grants.

Agent Capabilities

Because the agent loop is always active, the chat can:

  1. Plan — break tasks into steps
  2. Use tools — search, browse, file ops, code execution, media generation
  3. Iterate — execute steps, evaluate results, adapt
  4. Run workflows — trigger saved NodeTool workflows

Common Tools

ToolCapability
google_searchWeb search
browserBrowse and extract web content
read_file / write_file / edit_fileWorkspace file ops
grep / globSearch files
screenshotCapture a page screenshot
find_modelPick a model by capability
generate_image / generate_video / generate_speechMedia generation

Restrict the set with --tools a,b,c; inspect the active set with /tools.

Global Chat

Global Chat is the desktop app's built-in chat interface.

Features

  • Chat with any configured AI model (OpenAI, Anthropic, Gemini, local)
  • Multiple conversation threads
  • Standalone window (launch from the system tray)
  • Tools: web search, image generation, workflow execution
  • The same always-on agent loop as the CLI

Workflow Integration

1. Save a workflow in the NodeTool editor
2. Open Global Chat
3. Select the workflow from the workflow picker
4. Chat naturally — the agent can invoke the workflow as a tool

Typical Flows

Quick Question

bash
nodetool chat -p openai -m gpt-5.4
> What's the difference between FAISS and ChromaDB?

Research Task

bash
nodetool chat --tools google_search,browser,write_file
> Research the top 5 TypeScript ORMs and write a comparison to comparison.md

Code Generation

bash
nodetool chat -p anthropic -m claude-sonnet-4-6 --tools write_file,read_file,grep
> Create a Python script that processes CSV files and generates summary statistics

Headless / Programmatic Chat

For non-interactive chat, use the OpenAI-compatible Chat API on a running server (nodetool serve):

bash
curl -X POST http://localhost:7777/v1/chat/completions \
  -H "Authorization: Bearer TOKEN" \
  -d '{"model": "gpt-5.4", "messages": [{"role": "user", "content": "Hello"}]}'

Common Pitfalls

  • No provider configured: store a key first (nodetool secrets store OPENAI_API_KEY). The /model picker lists models only from configured providers.
  • Wrong model ID: switch with /model <provider>/<id>; the picker searches every configured provider.
  • Expecting a shell: bare commands like ls are sent to the model, not run. Use the agent's file tools instead.
  • Looking for /agent: agent mode is always on; there is no toggle.
  • Using /agent: the command inspects delegated sub-agent threads; it does not toggle agent mode.

© nodetool-ai, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/system-skills/nodetool-chat-cli of nodetool-ai/nodetool.

Open the folder on GitHubat commit 515bd28

Compare with similar skills

Nodetool Chat CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nodetool Chat CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nodetool Chat CLI this skillnodetool-ai/nodetool556—~1.8kAutomated safety check: PassAGPL-3.0
Summarizeswarmclawai/swarmclaw688—~531Automated safety check: PassMIT
Gemini Video Understandingeinverne/dotfiles1211 repos~2.6kAutomated safety check: NotesMIT
Agent BuildershareAI-lab/learn-claude-code78k6 repos~1.2kAutomated safety check: PassMIT
Planning With Filesjarrodwatts/claude-code-config1.1k5 repos~967Automated safety check: PassNone
Codebase Managementgiancarloerra/SocratiCode3.3k1 repos~1.8kAutomated safety check: PassAGPL-3.0

Similar skills

  • Summarize

    swarmclawai/swarmclaw

    Summarize or extract text/transcripts from URLs, podcasts, YouTube videos, and local files using the summarize CLI.

    688 GitHub stars~531 tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Analyze videos using Google's Gemini API - describe content, answer questions, transcribe audio with visual descriptions, reference timestamps, clip videos, and process YouTube URLs.

    121 GitHub starsUsed in 1 repo~2.6k tokens
    AI & LLM EngineeringAuto-check: notes
  • Agent Builder

    shareAI-lab/learn-claude-code

    Design and build AI agents for any domain. An agent skill from shareAI-lab/learn-claude-code.

    78k GitHub starsUsed in 6 repos~1.2k tokens
    AI & LLM EngineeringAuto-check passed
  • Planning With Files

    jarrodwatts/claude-code-config

    Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage.

    1.1k GitHub starsUsed in 5 repos~967 tokens
    AI & LLM EngineeringAuto-check passed
  • Codebase Management

    giancarloerra/SocratiCode

    Set up, index, and manage SocratiCode codebase indexing. An agent skill from giancarloerra/SocratiCode.

    3.3k GitHub starsUsed in 1 repo~1.8k tokens
    AI & LLM EngineeringAuto-check passed
  • Context Compression

    guanyang/open-agent-hub

    This skill should be used when long-running agent sessions need context compression, structured summarization, compaction, token-per-task optimization, or durable handoff summaries that preserve…

    975 GitHub starsUsed in 2 repos~4.6k tokens
    AI & LLM EngineeringAuto-check passed

More from nodetool-ai/nodetool

All 127 skills in this repo
  • Beat Sync Editing

    nodetool-ai/nodetool

    Cut a NodeTool timeline to music and shape its pacing — detect the beat grid, place cuts on phrases, pick a cut type, build speed ramps with time remap, and give the piece an arc.

    556 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Caption Titles

    nodetool-ai/nodetool

    Add and animate a consistent text layer on an existing NodeTool timeline.

    556 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Color Motion

    nodetool-ai/nodetool

    Choose and animate colour on a NodeTool timeline, including shape and text gradients, colour grades, 3D LUTs, and dither.

    556 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Commercial Beat Sheet

    nodetool-ai/nodetool

    Write a shootable, precisely timed commercial beat sheet and store it as a NodeTool storyboard, with a consistent entity roster behind every shot.

    556 GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • Elevenlabs Audio Prompting

    nodetool-ai/nodetool

    Direct ElevenLabs speech, dialogue, sound effects and music — the bracketed audio tags v3 acts on and why the voice decides whether a tag lands, stability as the delivery dial, punctuation instead…

    556 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Frame Composition

    nodetool-ai/nodetool

    Stage the frame on a NodeTool timeline — grids, focal placement, safe areas per aspect ratio, depth layers and parallax, camera moves, and where elements enter and leave.

    556 GitHub stars~3.5k tokensUpdated today
    Auto-check passed

Questions about Nodetool Chat CLI

What does Nodetool Chat CLI do?

Use NodeTool chat CLI sessions, provider selection, workspace tools, and Global Chat features. Nodetool Chat CLI is an agent skill from nodetool-ai/nodetool. Use NodeTool chat CLI sessions, provider selection, workspace tools, and Global Chat features.

When should I use Nodetool Chat CLI?

Nodetool Chat CLI fits situations like: AI & LLM Engineering work in your project.

How do I install Nodetool Chat CLI in Claude Code?

Run `npx skills add nodetool-ai/nodetool --skill nodetool-chat-cli -a claude-code`. Or copy the skill folder (packages/system-skills/nodetool-chat-cli in nodetool-ai/nodetool) into .claude/skills/nodetool-chat-cli in your project. Claude Code loads it when a task matches its description.

How do I install Nodetool Chat CLI in Codex?

Run `npx skills add nodetool-ai/nodetool --skill nodetool-chat-cli -a codex`. Or copy the skill folder (packages/system-skills/nodetool-chat-cli in nodetool-ai/nodetool) into .agents/skills/nodetool-chat-cli in your project. Codex loads it when a task matches its description.

Can I use Nodetool Chat CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nodetool-ai/nodetool --skill nodetool-chat-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nodetool-chat-cli, .gemini/skills/nodetool-chat-cli, .github/skills/nodetool-chat-cli and .opencode/skills/nodetool-chat-cli in your project.

What does Nodetool Chat CLI need to run?

Going by SKILL.md and its folder, Nodetool Chat CLI needs the command-line tools its instructions call (curl and npm) and credentials named OPENAI_API_KEY. Our summary lists: Python 3; A credential in OPENAI_API_KEY.

Does Nodetool Chat CLI access the network?

SKILL.md contains no URLs. Its commands use curl and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Nodetool Chat CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nodetool Chat CLI use?

Nodetool Chat CLI is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nodetool Chat CLI use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nodetool Chat CLI?

Skills that share tags, products or a category with Nodetool Chat CLI: Summarize (swarmclawai/swarmclaw, 688 stars), Gemini Video Understanding (einverne/dotfiles, 121 stars), Agent Builder (shareAI-lab/learn-claude-code, 78k stars) and Planning With Files (jarrodwatts/claude-code-config, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nodetool Chat CLI?

nodetool-ai (a GitHub organization) maintains it in nodetool-ai/nodetool, which has 556 GitHub stars. The repository holds 127 skills in this directory. The repository was last updated on October 8, 2026.

Source: nodetool-ai/nodetool on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.