Skip to main content

Build with a coding agent

This is the fastest way to start on Blocks OS. It works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot and the other agents listed on the Agent Skills page.

1. Bootstrap the repository​

Open a terminal in a git repository, new or existing, start your coding agent, and paste:

Read https://seliseblocks.com/bootstrap and follow it to bootstrap this repo, then help me sign in and get started with SELISE Blocks.

The agent:

  1. Asks which coding agents you use and confirms the files it will write.
  2. Installs the Blocks Skills into .agents/skills/ and the routing rules into AGENTS.md.
  3. Asks before installing the CLI with npm install -g @seliseblocks/cli-os@latest.
  4. Runs blocks login, which opens a device-code sign-in in your browser. You never give the agent a password.
  5. Lists your projects and lets you choose one, or offers to create one after you accept the Blocks terms.
  6. Scaffolds a frontend with blocks new web and points it at the project.

If you already have a project key, add it to the prompt and skip the picker:

Read https://seliseblocks.com/bootstrap and follow it to bootstrap this repo, then get me set up on project <x-blocks-key> and show me what's already there.

2. Describe what you want​

After bootstrap you talk to the agent normally. It picks the right skill.

Create a Product schema with title, price, description and tags, then reload it.
Add typed CRUD for the Product schema to this app.
Configure SSO for this project and add the login flow to the frontend.
Add German and French translations for the login page and a language switcher.
Run this app locally over HTTPS on its Blocks domain.

Configuration changes go through the blocks CLI. Application code goes through the @seliseblocks/client SDK. The agent never calls the Blocks HTTP API directly.

3. Check your state at any time​

blocks auth status --json
blocks doctor --json
blocks projects list --json

Without an agent​

The same path works by hand:

npm install -g @seliseblocks/cli-os@latest
blocks login
blocks projects list --json
blocks use <tenantId>
blocks new web my-app

Run blocks help <command> for the exact flags of any command. The CLI README covers accounts, profiles and configuration.

Next steps​