Gipity CLI

Connect AI coding agents to the Gipity platform. Built for Claude Code and works great from your terminal too.

Gipity gives your AI agent a persistent workspace with file storage, databases, code execution, deployment, memory, workflows, and more. This CLI is the bridge.

Install

npm install -g @gipity/cli

Requires Node 18+.

Quick Start

One command. It walks you through login, project setup, and drops you into Claude Code.

gipity start-cc --dangerously-skip-permissions

That's it. You'll see:

  Welcome to Gipity
  ─────────────────

  Email: [email protected]
  Check your email for a 6-digit code.

  Code: 482910
  Authenticated as [email protected]

  Your projects:
    1. my-website (my-website)
    2. Create new project

  Choose (1-2): 2
  Project name [project01]: cool-app
  Creating "cool-app"...
  Created.

  Launching Claude Code...

If you're already logged in, it skips straight to project setup. If you already have a project in the current directory, it skips straight to launching Claude Code.

Projects live in ~/GipityProjects/{project-slug}/ — created automatically on first use. Any extra flags (like --dangerously-skip-permissions, --model opus, etc.) get passed through to Claude.

The manual way

If you prefer to do things step by step:

gipity login --email [email protected]
gipity login --code 123456
cd my-project
gipity init
claude

Claude Code Integration

This is the good part. When you run gipity init in a project, it sets up two hooks in .claude/settings.json:

Auto-push — Every time Claude Code writes or edits a file, it gets pushed to Gipity in the background. No extra steps.

Auto-pull — Before each turn, Claude Code pulls any changes that happened remotely (like if your Gipity agent built something via chat). Claude sees what changed and can pick up where things left off.

That means Claude Code and your Gipity agent share the same files, same project, same context. You get the best of both — Claude Code for hands-on coding, Gipity for autonomous agent work.

What gets set up

.gipity.json          # Project config (which project, which agent)
.gipity/              # Local sync state (gitignored)
.claude/settings.json # Hooks for auto-push and auto-pull
CLAUDE.md             # Gipity commands reference for Claude Code

Manual sync

If you ever need to sync manually:

gipity sync check    # See what's different
gipity sync up       # Push local changes
gipity sync down     # Pull remote changes

Commands

| Command | What it does | |---------|-------------| | gipity start-cc | Log in, pick a project, and launch Claude Code — all in one | | gipity login | Authenticate with email + verification code | | gipity init | Set up a Gipity project and configure Claude Code | | gipity status | Show project, agent, and auth info | | gipity sync | Sync files between local and Gipity | | gipity push <file> | Push a single file | | gipity deploy [dev\|prod] | Deploy your project to the web | | gipity chat <message> | Send a message to your Gipity agent | | gipity db | Query, list, or create project databases | | gipity memory | Read/write agent and project memory | | gipity sandbox run <code> | Execute code in a sandboxed container | | gipity api | Define and manage API procedures | | gipity project | List, create, switch, or delete projects | | gipity agent | List, create, switch, or configure agents | | gipity workflow | Manage and trigger automated workflows | | gipity file | Browse remote files (ls, cat, tree) | | gipity scaffold [title] | Create web app structure (HTML, CSS, JS, favicons) | | gipity checkpoint | List or restore file snapshots (undo) | | gipity logs fn <name> | View function execution logs | | gipity browser <url> | Inspect a URL: console errors, performance, failed resources | | gipity records | Query and manage Records API tables | | gipity fn | Manage and call sandboxed functions | | gipity rbac | Manage RBAC policies | | gipity audit | Query audit logs | | gipity credits | Check your balance and usage |

Every command supports --json for scripted/programmatic use.

deploy

gipity deploy          # Deploy to dev (dev.gipity.ai)
gipity deploy prod     # Deploy to production (app.gipity.ai)

Your project gets a live URL at https://dev.gipity.ai/{account}/{project}/.

chat

Talk to your Gipity agent from the terminal. If the agent creates or modifies files, they sync back automatically.

gipity chat "Build me a landing page"
gipity chat "Add a contact form" --new    # Start a fresh conversation

db

gipity db list
gipity db query "SELECT * FROM users LIMIT 10"
gipity db query "SELECT * FROM orders" --database my_app_db

memory

Agent memory persists across all conversations. Project memory is scoped to one project.

gipity memory list
gipity memory read preferences
gipity memory write api_keys "stripe: sk_live_..."
gipity memory write design_notes "use dark theme" --project

sandbox

Run code in a sandboxed Docker container with no network access. JavaScript, Python, and Bash.

gipity sandbox run "console.log('Hello')"
gipity sandbox run "import pandas; print(pandas.__version__)" --lang py
gipity sandbox run "echo hello" --lang bash

api

Define SQL-backed API endpoints that your deployed apps can call.

gipity api list
gipity api define get_users --sql "SELECT * FROM users" --database mydb --auth public
gipity api define create_post --sql @queries/create_post.sql --database mydb --method write

workflow

gipity workflow                        # List workflows
gipity workflow run daily_report       # Trigger manually
gipity workflow enable daily_report    # Turn on cron schedule
gipity workflow runs daily_report      # View recent runs

agent

gipity agent                           # List agents
gipity agent create "Research Bot"     # Create a new agent
gipity agent set model claude-opus     # Change the model
gipity agent "Research Bot"            # Switch active agent

project

gipity project                         # List projects
gipity project create "My App"         # Create new project
gipity project my-app                  # Switch active project

Project Config

.gipity.json

Created by gipity init. Links your local directory to a Gipity project.

{
  "projectGuid": "prj-a1b2c3d4",
  "projectSlug": "my-app",
  "accountSlug": "steve",
  "agentGuid": "agt-x1y2z3w4",
  "apiBase": "https://a.gipity.ai",
  "ignore": ["node_modules", ".git", "dist", ".env"]
}

~/.gipity/auth.json

Your login tokens. Created by gipity login. Tokens auto-refresh so you shouldn't need to log in again unless you've been away for a week.

Questions?

Reach out anytime — [email protected]

This is early and moving fast. If something's broken or confusing, I want to hear about it.

-- Steve Iverson