Tooling · 0.55.16
Build the app. Inspect the workspace. Operate the right surface.
This section covers the systems developers and coding agents work with. It also explains the runtime surfaces that application agents use. Those surfaces aren't interchangeable. Every claim in this section was checked against the released 0.55.16 packages.Three audiences
Developers create projects, change models, generate artifacts, run tests and apply migrations. CI runs the same project checks and generation commands. These actions can write files or change the configured development database.
Coding agents inspect source, manifests, package contracts and generated knowledge. Development MCP is read-only. If an agent can also edit the repository, that permission comes from the coding-agent client.
Application agents use generated local MCP, hosted application MCP or WebMCP. Their calls can operate live data, and they stay inside the application authentication, tenant, permission and field-policy boundaries.
Separate surfaces
| Surface | Primary audience | Boundary | Reach for it when |
|---|---|---|---|
| CLI, templates, and scanner | Developers and CI | Runs in the local workspace. Commands can create files, generate artifacts, inspect manifests, and apply migrations to the configured database. | You need to start an app, change its model, generate interfaces, verify it, or operate its development database. |
| Knowledge commands | Developers and coding agents | Reads workspace files, generated knowledge, installed-package contracts, and git history. It does not inspect live application data. | You need a deterministic index, freshness result, change report, or review and architecture context. |
| Development MCP | Coding agents | Runs as a local, read-only stdio server. It inspects the workspace and installed packages but cannot access the running application. | A coding agent needs structured discovery, diagnostics, generation output, or review context through MCP. |
| Generated local MCP | Local application agents | Runs beside the application and operates live data. It gets credentials from its environment and has no per-request principal, so it stays local. | A trusted application agent on the same machine must use generated model operations. |
| Hosted application MCP | Remote application agents | Runs as a stateless HTTP route. A gateway terminates authorization, and the application resolves a principal for each request. | A remote application agent needs permitted operations against a deployed application. |
| WebMCP | Browser-session application agents | Registers tools in the browser page and calls the generated REST surface as the signed-in page user. It is not a separate server. | An application agent in the browser must use actions that the current page exposes. |
| Agent Plugin | Coding-agent clients | Packages the same local Development MCP server with manifests, schemas, and skills. The client keeps credentials outside the package. | A compatible coding-agent client can discover the development integration from a package. |
Pages in this section
This page connects the tools a developer uses from the first scaffold through model changes, tests, migrations, and local operation.
→Knowledge toolingThese commands answer "what is actually in this repository, and is the written description of it still true?" They compute the answer from the workspace rather than asking a model.
→smrt-dev-mcpThe default read-only stdio server helps a coding agent understand your codebase. It returns generated source as output but never writes it. The Level 1 and Level 3 runtime paths have their own scoped access to framework tables or the live application registry.
→Generated and app MCPThese surfaces let an application agent operate real data. Local stdio gets credentials from its environment. Hosted MCP resolves a principal per request. WebMCP uses the signed-in browser session.
→Agent Plugin packagingA compatible coding-agent client can read two small manifests instead of a configuration file. The manifests identify the local server launcher and the bundled skill location.
→Compatibility and operationsThis page records the framework promises for protocol behavior and migration compatibility. It also lists the first checks for an unresponsive server.
→