Agno

uv add 'mirage-ai[agno]'

import asyncio

from agno.agent import Agent
from agno.models.openai import OpenAIChat

from mirage import MountMode, RAMVFS, Workspace
from mirage.agents.agno import MirageToolkit

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

agent = Agent(
    model=OpenAIChat(id="gpt-5.4-mini"),
    tools=[MirageToolkit(ws)],
    instructions=("You have access to a virtual filesystem via shell "
                  "tools. Use them to explore and read files."),
    markdown=True,
)


async def main() -> None:
    await ws.shell('echo "hello from mirage" | tee /data/hello.txt')
    await agent.aprint_response(
        "List all files under /data and show the contents of each one.")


asyncio.run(main())