Documentation

Point to your running OpenAPI at http://localhost:9000/openapi.json and rebuild to pull live endpoint listings into the homepage. Below are example patterns.

Ephemeral shell (API)

curl -X POST \
  -H 'Authorization: Bearer $GENTILITY_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "command": "echo hello && ls -la",
    "timeout": 120,
    "artifacts": true
  }' \
  https://api.gentility.ai/v1/shells:run

Persistent shell (MCP)

Connect your MCP client with a Gentility server target and request a persistent shell. Reset when needed. Note: MCP features require a client with MCP support such as ChatGPT (Plus required) or Claude (Pro required).

# mcp.yaml
targets:
  - name: team-prod
    type: shell
    url: mcp+gentility://your-org/team-prod
    token: $GENTILITY_API_KEY

Read-only DB session

curl -X POST \
  -H 'Authorization: Bearer $GENTILITY_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "target": "postgres://...",
    "mode": "read_only"
  }' \
  https://api.gentility.ai/v1/db:sessions

Command filtering

# example policy.json
{
  "shell": {"deny": ["rm -rf /", "shutdown -h now"]},
  "db": {"deny": ["DROP TABLE", "DELETE FROM"], "allow": ["SELECT"]}
}