OpenHands

uv add 'mirage-ai[openhands]'

import os
from openhands.sdk import LLM, Agent, Conversation, Tool

from mirage import MountMode, Workspace
from mirage.agents.openhands import MirageWorkspace, register_mirage_terminal
from mirage.resource.ram import RAMResource

ws = Workspace({"/": RAMResource()}, mode=MountMode.WRITE)

llm = LLM(
    model=os.getenv("LLM_MODEL", "anthropic/claude-sonnet-4-6"),
    api_key=os.getenv("LLM_API_KEY"),
)

with MirageWorkspace(workspace=ws, working_dir="/") as mirage_ws:
    tool_name = register_mirage_terminal(mirage_ws)
    agent = Agent(
        llm=llm,
        tools=[Tool(name=tool_name)],
        system_message=ws.file_prompt,
    )
    conversation = Conversation(agent=agent, workspace=mirage_ws)
    conversation.send_message("Create /hello.txt with 'hi' and ls /.")
    conversation.run()