CLI
Applications
List applications from your self-hosted Hookie database
The apps command lists applications visible to the signed-in user in your Supabase-backed app. You can optionally scope by organization.
Basic Usage
List all applications:
hookie appsExample Output
+----------+------------------+--------+------------------------------------------+
| ID | NAME | TOPICS | DESCRIPTION |
+----------+------------------+--------+------------------------------------------+
| app_123 | My Webhook App | 5 | Webhook receiver for payment events |
| app_456 | API Gateway | 12 | Central API gateway for microservices |
+----------+------------------+--------+------------------------------------------+The output shows:
- ID - Application identifier (use this with other commands)
- NAME - Application name
- TOPICS - Number of topics configured for this application
- DESCRIPTION - Application description (truncated if longer than 50 characters)
Filter by Organization
Filter applications by organization ID:
hookie apps --org-id <org-id>You can also set the organization ID globally:
hookie --org-id <org-id> appsExample
hookie apps --org-id org_abc123Authentication Required
You must be authenticated to list applications. If you're not logged in, you'll see:
Error: not authenticated. Run 'hookie login' firstRun hookie login to authenticate.
Use Cases
- Discover available applications - See all applications you have access to
- Find application IDs - Get the ID needed for other commands like
topicsandlisten - Check topic counts - Quickly see how many topics each application has
- Filter by organization - View only applications belonging to a specific organization
Related Commands
- Topics - List topics for a specific application
- Listen - Stream events from an application
- Authentication - Manage your CLI session