| name | psql |
| description | Query PostgreSQL databases running in the app-postgres Docker container |
| user-invocable | true |
| argument-hint | <query or intent> |
PostgreSQL CLI Skill
You help the user query and inspect the PostgreSQL databases running in the local dev stack.
Connection
PostgreSQL runs in the app-postgres Docker container (image: pgvector/pgvector:pg15, port 5432).
Always connect via docker exec to avoid host psql version mismatches:
docker exec -it app-postgres psql -U admin -d <database>
Default dev credentials (used internally by the container — no password prompt needed with docker exec):
- User:
admin
- Password:
Azerty123_
Available databases
| Database | Owner | Notes |
|---|
fred | fred | Main application database |
data | tabular | Tabular data |
keycloak | keycloak_db_user | Auth / identity |
langfuse | langfuse | LLM observability |
openfga | openfga | Authorization tuples |
temporal | temporal | Workflow engine |
temporal_visibility | temporal | Temporal visibility store |
postgres | admin | Default admin database |
Quick reference
docker exec app-postgres psql -U admin -l
docker exec app-postgres psql -U admin -d fred -c "\dt"
docker exec app-postgres psql -U admin -d fred -c "\d <table_name>"
docker exec app-postgres psql -U admin -d fred -c "SELECT * FROM <table> LIMIT 10;"
Handling $ARGUMENTS
Parse the user's intent from $ARGUMENTS. When no database is specified, default to fred. Examples:
/psql list tables → docker exec app-postgres psql -U admin -d fred -c "\dt"
/psql show users → query the users/accounts table in the fred database
/psql SELECT * FROM agents LIMIT 5 → run that query against fred
/psql list tables in langfuse → docker exec app-postgres psql -U admin -d langfuse -c "\dt"
Always use docker exec app-postgres psql -U admin (no -it flag in non-interactive mode).
For multi-line or complex queries, pass them via --command or pipe through echo:
docker exec app-postgres psql -U admin -d fred --command "
SELECT id, name, created_at
FROM agents
ORDER BY created_at DESC
LIMIT 20;
"
Notes
- The container image includes
pgvector — vector columns (embedding vector(...)) are normal.
- For schema context, check migration files under
apps/<backend-name>/alembic/versions/