Projects

A project is one git repository with a arise.toml at its root. The repo is the project — files, history, agent config, and settings all live in git. No separate database to keep in sync.

Backed two ways:

• Arise-managed repo — Arise creates and hosts a private repo (default).
• Imported GitHub repo — link an existing repo; Arise operates on it via the GitHub API.

Either way the project has a default_branch that every session branches from and every change request merges into.

What the control plane reads from arise.toml

• [project] — name, description
• [env] — secret names
• [sandbox] + .arise/Dockerfile — the sandbox image
• [opencode] config_dir — agent config location (default .arise/opencode)
• [[triggers]] — automations
• [[apps]] — deployable apps (experimental)

Unknown tables are ignored. Dashboard edits to triggers/env/apps are read-modify-writes on the same file, so in-session and dashboard edits round-trip.