mirror of https://github.com/hanzoai/python-sdk.git synced 2026-10-23 20:23:00 +00:00

Files

T

zeekay 5636caf58c feat: add REPL, IDE tools and ZAP protocol

- hanzo-tools-repl: Multi-language REPL with Jupyter kernel backend
  - Supports Python, Node.js/TypeScript, Bash, Ruby, Go, Rust
  - Persistent sessions for stateful evaluation
  - History and completion support

- hanzo-tools-ide: IDE integration for VS Code, Cursor, JetBrains
  - Full editor control (open, edit, navigate, refactor)
  - Terminal integration
  - Diagnostics and quick fixes
  - WebSocket bridge to IDE extensions

- ZAP Protocol (proto/zap/):
  - MCP superset for agentic operations
  - Streaming, REPL sessions, IDE integration
  - Browser DevTools support
  - Extension bridge specification

- hanzo-mcp v0.11.7:
  - Added [repl], [ide], [interactive] extras

2026-01-22 15:47:55 -08:00

2.3 KiB

Raw Permalink Blame History

hanzo-tools-ide

IDE integration tool for VS Code, Cursor, Windsurf, JetBrains, and LSP-compatible editors.

Features

Multi-IDE support: VS Code, Cursor, Windsurf, JetBrains, Neovim
Full editor control: Open, edit, navigate, refactor
Terminal integration: Create and send commands to terminals
Diagnostics: Access errors, warnings, and quick fixes
Agent-friendly: Designed for AI agent workflows

Installation

pip install hanzo-tools-ide

Requirements

Install the Hanzo extension in your IDE:

VS Code/Cursor/Windsurf: Install "Hanzo AI" extension
JetBrains: Install "Hanzo AI" plugin
Neovim: Install hanzo.nvim plugin

Usage

from hanzo_tools.ide import IdeTool

ide = IdeTool()

# Connect to IDE (auto-detects)
await ide.call(action="connect")

# Open file
await ide.call(action="open", path="/src/main.py", line=42)

# Insert text
await ide.call(action="insert", text="# TODO: fix", line=10)

# Go to definition
await ide.call(action="go_to_definition", line=15, column=8)

# Rename symbol
await ide.call(action="rename", new_name="betterName", line=10, column=5)

# Run in terminal
await ide.call(action="terminal", command="npm test")

# Get diagnostics
await ide.call(action="diagnostics", severity="error")

# Execute VS Code command
await ide.call(action="command", command="editor.action.formatDocument")

Actions

Action	Description	Parameters
connect	Connect to IDE	ide?: vscode\|cursor\|jetbrains
status	Check connection	-
open	Open file	path, line?
close	Close file	path?
save	Save file	path?
files	List open files	-
select	Set selection	line, column, end_line?, end_column?
insert	Insert text	text, line, column?
replace	Replace text	text, line, column, end_line, end_column
get_text	Get text	line?, end_line?
go_to_definition	Navigate	line, column
find_references	Find refs	line, column
rename	Rename symbol	new_name, line, column
format	Format doc	-
diagnostics	Get errors	severity?
quick_fix	Apply fix	line, column, index?
command	Execute cmd	command, args?
terminal	Terminal	command?, name?
search	Search	query, include?, exclude?

License

MIT - Hanzo Industries Inc

2.3 KiB Raw Permalink Blame History