# Gemini CLI + Ample: deploy apps from Gemini CLI

Set up Gemini CLI to deploy apps to Ample: connect the MCP server, sign in, and add the skills.

### the short version

To let Gemini CLI deploy to Ample, connect it to Ample's MCP server at https://api.ample.computer/mcp and sign in with your email (a 6-digit code, no password). Then ask it to deploy: Ample builds the app, returns a live HTTPS URL, and explains any failure so Gemini CLI can fix it.

## Set up Gemini CLI for Ample

1. **Install Gemini CLI.**

```sh
   $ npm install -g @google/gemini-cli
   ```

2. **Connect Gemini CLI to Ample's MCP server.** Without `--scope user` the server is added to this project's `.gemini/settings.json`.

```sh
   $ gemini mcp add --transport http --scope user ample https://api.ample.computer/mcp
   ```

3. **Sign in.** Gemini CLI starts sign-in when it connects to Ample; if it doesn't, run this in a session. Ample asks for your email and sends a 6-digit code; a new email gets a Free account. Then approve the connection.

```text
   /mcp auth ample
   ```

4. **Add the Ample skills (optional).** Three skills teach Gemini CLI when and how to deploy, connect services and migrate. Remove the directories to uninstall.

```sh
   $ curl -fsSL https://ample.computer/skills.sh | sh -s -- .agents/skills
   ```

5. **Ask it to deploy.** The deploy waits until the app is live or failed and returns the URL. On failure the result says who must act and suggests a fix.

```text
   Deploy this app to Ample and give me the URL.
   ```

## Example prompts

Say any of these to Gemini CLI. Copy one and paste it in.

- “Deploy this app to Ample and give me the URL.”
- “Add a Postgres database to this app on Ample and redeploy.”
- “The Ample deploy failed. Read the logs, fix the cause and deploy again.”
- “Put the uploads in an Ample bucket and serve them from the CDN.”
- “Move this app from Heroku to Ample.”

## Notes

- Gemini CLI reads `GEMINI.md`; to have it read `AGENTS.md` too, set `{\"context\": {\"fileName\": [\"AGENTS.md\", \"GEMINI.md\"]}}` in its settings.

## Sources

- https://geminicli.com/docs/tools/mcp-server/
- https://geminicli.com/docs/cli/skills/
- https://geminicli.com/docs/get-started/installation/
