Open Go framework for building company web apps with AI assistants. Pages are rendered on the server from templates that compile to type-checked Go, and every page has an access rule. Building blocks give an app the viewer's identity, its own SQL database, file stores, mail, settings, secrets, telemetry and calls to other apps, with no password or key in the app. A CLI, a local runner and a local MCP server come with it; queues, schedules, outbound HTTP and a test kit come later.
Module: aicoded.dev/framework
Status: pre-release. No API is stable and nothing here is ready for use yet.
You need Go 1.26 or later and Chrome. go install puts aicoded in $(go env GOPATH)/bin,
which must be on your PATH. aicoded from v0.3.0 on, and every app, need Go 1.26: with the
default GOTOOLCHAIN=auto an older go command downloads it, and with GOTOOLCHAIN=local it
refuses.
go install aicoded.dev/framework/cmd/aicoded@latest # the released aicoded
aicoded init hello # creates the app hello in a new folder
cd hello
aicoded dev # runs it on your computerOpen http://hello.localhost:8080/ and switch test personas at
http://hello.localhost:8080/_aicoded/persona. aicoded dev also prints a login link to its dev
UI, where you start and stop the apps and read their logs, traces and caught mail.
To work on the framework itself, run make install in a checkout of this repository instead: its
aicoded creates apps on that checkout through a replace line, which the delivery pipeline
refuses.
Tag the framework v<x.y.z> and push the tag. Then scripts/release-cli.sh v<x.y.z> tags
cmd/aicoded/v<x.y.z>: a commit on top of that tag whose cmd/aicoded/go.mod requires the
released framework with no replace. Push that tag too, and
go install aicoded.dev/framework/cmd/aicoded@v<x.y.z> installs the released aicoded.
The quick start guide goes on from there: what the new app holds, how to change its page and how to check it.
The docs live in docs/ and are built into aicoded: aicoded explain <topic> prints one
offline, and the howto tool of aicoded mcp gives the same pages to your AI assistant.
llms.txt lists them all.
- Guides, starting with the overview of how an app works:
- pages: the quick start, project structure, template syntax, expressions, routing, access, forms, live values, page calls, assets, the TypeScript API, the web API and the request pipeline;
- building blocks, calls and tools: the permission list, the SQL database, file stores, mail,
settings and secrets, telemetry, calls between apps,
aicoded dev, the tools, MCP, publishing and the simulated attacks.
- Error catalogue: every error code, with its fix.
- Examples: people, a staff directory; contacts, the app it calls; and room-maintenance, a list of tickets with an ownership check.
- Changelog for AI assistants: changes to the API, newest first.
Go 1.26 or later. An app that keeps data in its SQL database needs a MySQL 8 server on your
computer to run under aicoded dev.
make tools # installs golangci-lint, govulncheck, gitleaks, buf and the protobuf plugins
make check # checks the generated protobuf code, in every module runs go test -race,
# golangci-lint run and govulncheck, and runs make secrets- Tests that need MySQL read the admin DSN of a MySQL 8 server from
AICODED_TEST_MYSQL_DSNand skip without it;AICODED_E2E_MYSQL=requiredmakes them fail instead. The examples' database tests open the test database thataicoded checkmakes, sogo testin an example skips them, and the end-to-end tests run them on that server with nothing skipped. The browser tests need Chrome, andAICODED_E2E_BROWSER=requiredmakes them fail without it. make docsrewritesllms.txtand the code the docs quote from the examples;go test ./docs/fails until both are current.make secretslooks for leaked passwords and keys with gitleaks and its default rules: in every commit reachable fromHEAD, and in every file git tracks or would track, so other branches, the stash and ignored folders are not scanned. An inlinegitleaks:allowhas no effect. A finding is fixed at its source; one that stays in an old commit is listed by its commit fingerprint,<commit>:<file>:<rule>:<line>, in.gitleaksignore, with a comment saying what it is.make secretsrefuses any other line in that file, and any file path with a colon.
Apache License 2.0 — see LICENSE.