Skip to content

About

A self-hosted artifact workspace for people and AI agents. Go + React, live editing, MCP, and local storage.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

30 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CodeXArtifacts

A self-hosted workspace for artifacts you and your AI agents can keep building on.

Connect an agent, create something useful, then return to it in the browser. Keep web pages, documents, slides, designs and boards together—with sharing and version history.

Website · Quick start · Connect your agent · Documentation

CodeXArtifacts library showing web pages, documents, slides, designs and boards together

Actual application screenshot with demonstration content.

Formats

Type in the app What you can make
Web page HTML and React pages, interactive tools
Doc Notes, project briefs and documents
Slides Presentations with editable slides
Design Page layouts with desktop and mobile frames
Board Whiteboards, flows and connected ideas

Docs, Design and Board support live browser collaboration. Artifacts start private; you choose who can view or edit them. See format details and exports.

Quick start

With Docker and Compose, download compose.release.yaml as compose.yaml into a new directory, then run:

docker compose pull app
docker compose run --rm app init /data
docker compose run --rm password cat /data/admin-password
# Store the password privately before removing the bootstrap file.
docker compose run --rm password rm /data/admin-password
docker compose up -d

Open http://localhost:8080 and sign in as admin with the saved password. The image supports Linux AMD64 and ARM64. Docker keeps accounts, artifacts and uploads in the Compose data volume. See deployment and updates for HTTPS, OIDC and backups.

Build from source

Install Go 1.27.1, Git and Make, then run:

git clone https://github.com/iml885203/code-x-artifacts.git
cd code-x-artifacts
make build
./bin/codexartifacts init
./bin/codexartifacts

The build downloads its pinned Node.js locally; you do not need to install Node separately.

Open http://localhost:8080. Sign in as admin using the password in .local/admin-password. Save the password, then delete that plaintext file. Keep the rest of .local/ private—it holds your accounts, database and files. Use localhost rather than its IP address for local sign-in.

Prefer containers? Follow the Docker Compose instructions.

Connect your agent

Claude Code, Codex, Cursor, OpenCode and other MCP clients connect through MCP to the same CodeXArtifacts workspace

Connect multiple agents to the same artifacts. With OAuth enabled, add the MCP URL to your client, sign in and approve access in your browser. Each client has its own authorization, which you can revoke independently.

  1. Open Connect your agent in the app and copy the MCP URL into your client.

  2. Complete browser authorization. For clients without OAuth, use a separate personal token.

  3. Ask the first agent to create an artifact:

    Publish a one-page project overview to CodeXArtifacts.

  4. Continue from a different connected agent:

    Open the project overview in CodeXArtifacts and add a next-steps section.

Both agents work in the same workspace; you can inspect the result in the browser. Each client connects independently with the authorizing account's artifact permissions.

Manual connection settings
Setting Value for the local quick start
Server URL http://localhost:8080/api/mcp
Transport Streamable HTTP
Authentication Authorization: Bearer <YOUR_TOKEN>

For a remote workspace, use its HTTPS address instead of localhost. Use your client's remote MCP configuration format; the app provides ready-to-copy settings for Claude Code and Codex, plus a generic JSON example for other clients. OAuth-capable clients can use the URL without a manually copied token when the operator has enabled OAuth. See OAuth setup and compatibility.

Limitations

  • Early release. No external security review or production-readiness claim.
  • One server instance. Go + React, SQLite and local files; multiple replicas are unsupported.
  • Operator-managed accounts. Local accounts, LDAP or OIDC; no built-in self-registration or email password reset.
  • Remote hosting needs HTTPS. Public links are off by default. See deployment and backups.
  • Format-specific limits apply. React uses a bundled runtime; DOCX export is experimental. Slides have a different editing model from Docs, Design and Board. See artifact contracts.

Development

See the development guide for builds, checks, browser tests and the website preview.

License

MIT. Based on owner-authorized Pictor source. Third-party code and fonts keep their own licenses: third-party notices.

About

A self-hosted artifact workspace for people and AI agents. Go + React, live editing, MCP, and local storage.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages