Tools Reference

Tools: Files & Search

File tools let you read, write, and inspect files in the project workspace, and search across source code.

zeeb_read_file

Read the contents of a file in the project workspace.

zeeb_read_file(path: str, project_id) → str

Arguments:

Name	Type	Description
`path`	string	Path relative to the project root (e.g. `blog/models.py`)
`project_id`	string	UUID of the target project

Returns: File contents as a string.

Example prompt: "Show me the contents of blog/models.py"

Write (create or overwrite) a file in the project workspace.

zeeb_write_file(path: str, content: str, project_id) → str

Arguments:

Name	Type	Description
`path`	string	Path relative to the project root
`content`	string	File content to write
`project_id`	string	UUID of the target project

Use this tool carefully — it overwrites the file without confirmation.

List files and directories in the project workspace.

zeeb_list_files(path?: str, project_id) → str

Arguments:

Name	Type	Description
`path`	string?	Subdirectory to list (default: project root)
`project_id`	string	UUID of the target project

Returns: Directory tree listing.

Get a full tree view of the project's directory structure.

zeeb_get_project_structure(project_id) → str

Returns: Recursive tree of the project root. Useful for orientation before generating code.

Search for a pattern in the project's source code.

zeeb_search_code(query: str, file_pattern?: str, project_id) → str

Arguments:

Name	Type	Description
`query`	string	Text or regex pattern to search for
`file_pattern`	string?	Glob to restrict search (e.g. `.py`, `/views.py`)
`project_id`	string	UUID of the target project

Returns: Matching lines with file path and line number.

Example prompt: "Find all places that import the User model"

List all apps in the project.

zeeb_list_apps(project_id) → str

Returns: App names and their paths within the project.

List all registered HTTP endpoints in the project.

zeeb_list_endpoints(project_id) → str

Returns: Method, path, view name, and permission classes for every registered route.

Same as zeeb_list_endpoints but includes internal framework routes.

zeeb_list_all_routes(project_id) → str

Get the JSON schema for a specific model. Useful for generating frontend types or API documentation.

zeeb_get_model_json_schema(app: str, model: str, project_id) → str