ide

Edits project source code through metatron's uri graph with subscription-based write-back to disk.

3|1|Updated Aug 22, 2025
One-click install
npx skills add https://github.com/phaseshift-studio/metatron --skill ide-phaseshift-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ide
Source: https://github.com/phaseshift-studio/metatron/tree/main/docs/website/skills/ide
Command: npx skills add https://github.com/phaseshift-studio/metatron --skill ide-phaseshift-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents working in the metatron VM need a structured way to read, edit, and persist source code without brittle text manipulation. This Skill lets an agent pull a source file into a rec-encoded code space, edit individual members (methods, fields, constructors) through anchored uri paths, and have subscriptions automatically write changes back to disk with a logged save event. ## Core Features & Use Cases - Graph-based source editing: Pull Java files into a code list and navigate them via an idx reprojection with human-readable paths like /dev/scratch/idx/Echo/method/speak. - Automatic write-back subscriptions: A ?subq subscription on code/# serializes edited rec structures to source text on disk and logs saved events. - Project infrastructure: Build a project::T consolidating source embeddings, spaces (memspace, fsspace, tblespace), and build commands such as mvn_build and mvn_clean. - Use Case: An agent needs to change the body of the speak method in Echo.java. It anchors the method via @/dev/scratch/idx/Echo/method/speak >>= [body=>...], re-saves the code entry, and the subscription writes the updated file to disk. ## Quick Start Ask the agent to pull the Echo class from the scratch project and update the body of its speak method, then verify the change on disk.

Frequently Asked Questions about ide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit a Java method through the metatron uri graph?

Pull the class with `src/.../ClassName()`, then update the anchored member path such as `@/dev/scratch/idx/Echo/method/speak >>= [body=> "..."]`. Re-save the code entry so the write-back subscription fires and persists the change to disk.

How does the agent ide write code changes back to disk?

A `?subq` subscription registered on `code/#` detects edits to the code list, serializes the rec structure into source text, writes it through the fsspace to the file system, and logs a `saved` event to the log space.

Can I use this skill without speaking mtron code directly?

Yes. Agents not encoded in metatron use the MCP server tool `eval` (`m_inst_eval_mtron`) to execute mtron expressions. The container launcher also provides `bin/agent-ide-eval '<mtron code>'` for evaluating through the MCP door.

Why did my body edit with a nested join expression not apply?

A nested `>>=[...]>>.>-join` inside `body=>` is silently dropped by the current VM build with no error. Compose the full new body as a concrete string and update with that instead, then re-save the code entry.

What are the limitations of the metatron agent ide?

Only Java files are supported so far. The `text` field is derived and must not be hand-edited, re-pulling a file resets in-memory edits, and publishing `idx` to an fs/mfs space fails because auto-at refs cannot be serialized there.