Chrysalis

The agent

The agent is the part of Chrysalis that changes Chrysalis. Ask it for a feature, a fix or a whole new app, and it edits the files while the app stays open.

#Ask for something

Open Agent from the launcher. To watch changes land as they happen, split an app's tab so the app sits beside the agent. Some things people ask for:

  • "Add a button to this chat that copies the last reply."
  • "Make the character list show the newest ones first."
  • "Build me an app for tracking the books I read, with a notes field."
  • "Why does my app show a blank page?"

When the agent saves a file, an open app updates in place without losing what you were doing. After each change the agent waits for the app to build and reads any errors, so it fixes its own mistakes before telling you it is done.

#Everything can be undone

Your workspace (your apps and their data) is a git repository. Every file the agent writes is saved to its history under its name, so you can ask it to show what changed or to put a file back the way it was. Updates and imports are saved to the same history.

#What it can reach

  • Your workspace: your apps, their plugins and their data. It cannot read your model keys or other accounts.
  • A command shell that runs inside your browser tab, never on the server, with Python available. Turn it off with agent.shell in config.yaml.
  • Internet access in that shell, for things like curl and pip. It is on by default; turn it off in Settings > Agent. Your own computer and local network stay blocked either way.
  • Web search once you add a search key in Settings > MCP servers.
  • Tools from MCP servers you add in Settings > MCP servers.

For the admin, the agent can also change server settings, such as letting your phone connect. It always shows the exact change and waits for your approval.

#Choosing its model

The agent uses any model from your API connections. Pick one in the agent's model menu; Settings > Agent also holds its instructions and how it handles long sessions. Building apps works best with a strong coding model.

#How it works

How edits reach an open app, and the tools the agent uses to check its own work, are on Live editing.

Edit this page on GitHub