# NEXUS AI App Builder

The NEXUS AI App Builder provides an authenticated, chat-driven development workflow with live preview and deployment handoff.

## Capabilities

The Builder API supports sessions, messages, streaming messages, file snapshots, revert/checkpoints, model and provider selection, sandbox synchronization, share/remix links, and GitHub import or push.

The MCP server exposes `nexusai_builder_push` and `nexusai_builder_pull` so an agent can send a generated file set to a Builder session and read back the latest files after edits.

## Supported workflows

- Generate or import an application into a live preview.
- Push complete file snapshots from an agent.
- Pull the current Builder files after a user edits the preview.
- Revert a session to an earlier checkpoint.
- Push a completed project to a new or existing GitHub repository.
- Hand the project to the deployment pipeline.

## Safety

Builder sessions and source files may contain credentials or private code. Use scoped access, do not include secrets in files, and review a generated diff before deployment.

## Related resources

- [Projects](/docs/projects.md)
- [Deployment](/docs/deployment.md)
- [MCP tools](/mcp/tools.json)