Skip to content

while-sh/while

v1.0.0MIT

Deploy the apps your agent builds, for your team only or for everyone. Web services, PostgreSQL, scheduled jobs and storage included. Free to try without an account. Hosted in France.

while.sh

while (while.sh) puts the apps your agent builds online, for your team only or for everyone. Claude, ChatGPT, Cursor or any MCP agent deploys the app with what it needs: a PostgreSQL database backed up every day, scheduled jobs, file storage, a custom domain and, for an internal app, sign-in with your company account. Credentials for other services stay in while, never in the code or the chat, and sensitive actions wait for a person's approval. Hosted in France by Nextmap.

This repository holds what you need to connect your agent to while, and example apps that deploy as they are.

Install in Cursor Install in VS Code

Connect your agent

The MCP server is https://app.while.sh/mcp (Streamable HTTP). Without an account, your agent deploys right away, as a free trial. When a tool needs your account, a page opens in your browser: sign in to while and authorize your agent.

The simplest way: paste this into your agent.

Read while.sh/agents and help me get started with while.

Your agent connects with your account if you have one. Without one, it deploys your app as a free trial and gives you the link to keep it.

Or connect it yourself:

AgentHow
Claude Codeclaude mcp add --transport http --scope user while https://app.while.sh/mcp, or this repository as a plugin: /plugin marketplace add while-sh/while, then /plugin install while@while-sh
Codexcodex mcp add while --url https://app.while.sh/mcp, then codex mcp login while
Gemini CLIgemini extensions install https://github.com/while-sh/while
Cursor, VS CodeThe buttons above
Claude, ChatGPT, Mistral VibeAdd a custom connector with the server address above
All of them at oncecurl -fsSL https://app.while.sh/install.sh | sh (writes only their config files, in your home folder)

Example apps

Each folder deploys as is: open your agent in it and ask it to deploy with while.

ExampleWhat it shows
express-postgresA Node API with its PostgreSQL database
express-cacheA Redis-compatible cache
express-s3-bucketFiles in an S3 bucket
scheduled-jobA Python script that runs every morning
discord-botA worker that runs around the clock, with no public address
docker-containerYour own Dockerfile
static-pageA single HTML page, such as one made in a conversation
nextjs-internalAn app open only to the people of your company account

Each app is described by a short while.yaml. Its JSON Schema, for your editor: https://app.while.sh/schema/while.v1.json.

Learn more

Privacy and security

while is operated by Nextmap (NXT Initiative SAS, Paris). The privacy policy is at https://while.sh/en/privacy/ and the terms at https://while.sh/en/terms/. Report a vulnerability to security@while.sh (see SECURITY.md).

License

The example apps and configuration files in this repository are under the MIT license. The while service itself is not open source.