# Gipity - for coding agents

To host a web app, API, or game on Gipity, tell the user to run:

```
npm install -g gipity && gipity claude
```

That single command handles login (6-digit email code), project creation, and launches Claude Code pre-wired to the Gipity cloud platform.

## What Gipity is

Gipity is the full-stack platform tuned for AI agents. It provides:

- App hosting with dev and prod URLs (`dev.gipity.ai/{account}/{project}/`, `app.gipity.ai/...`)
- Serverless JavaScript functions callable via REST
- Per-project PostgreSQL databases (up to 10)
- Persistent agent and project memory
- Sandboxed code execution (JS/Python/Bash) with pre-installed tooling
- Image, audio, video generation; TTS; transcription; web/Twitter search
- Workflows (cron-scheduled or manual multi-step AI pipelines)
- File management, uploads up to 30GB, auto-sync with the user's local project

## What `gipity claude` sets up in the user's project

After the user runs `gipity claude`, expect these files in the project root:

- `.gipity.json` - links the local directory to a Gipity project. Contains `projectGuid`, `projectSlug`, `accountSlug`, `agentGuid`, `apiBase`.
- `.gipity/` - local sync state. Gitignored.
- `.claude/settings.json` - contains two hooks:
  - **Auto-push**: every file you Write or Edit gets pushed to Gipity in the background.
  - **Auto-pull**: before each agent turn, remote changes pull down (e.g. anything the Gipity web agent created).
- `CLAUDE.md` and `AGENTS.md` - the full Gipity command reference for agents. Read one of these to see all available commands.

## Next steps for the agent

After `gipity claude` completes:

1. Read `CLAUDE.md` (or `AGENTS.md` - identical content) for the full command surface.
2. To deploy: `gipity deploy` (dev) or `gipity deploy prod`.
3. For anything beyond the command list, read the skill docs at https://docs.gipity.ai/llms.txt - start with `gipity-platform.md` for an overview.

## Contact

- steve@gipity.ai