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

Files

T

zeekay 8c05bf99d6 fix(ci): pin black <26.1 to avoid internal error, lower requires-python to 3.12

Black 26.1.0 crashes on multiple exception types in parentheses.
The requires-python bump to 3.14 broke CI which runs Python 3.12.

2026-03-01 16:01:16 -08:00

hanzo_tools

style: auto-fix ruff lint and format for Python 3.12

2026-02-20 21:29:31 -08:00

pyproject.toml

fix(ci): pin black <26.1 to avoid internal error, lower requires-python to 3.12

2026-03-01 16:01:16 -08:00

README.md

feat: add REPL, IDE tools and ZAP protocol

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

README.md

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