CLI

Automate auth, app-scoped operations, and inspection with compact, script-friendly commands.

Core command pattern

Most workflows are: authenticate, set app context, read resources, mutate resources, validate state.

Daily operator loop

archastro login
archastro set app <app-id>
archastro status
archastro get resources
archastro get agents

CI-friendly usage

Use non-interactive auth/token flows in CI. Fail fast if app context is missing.

Guard clause in scripts

archastro status || exit 1
archastro get apps > /tmp/apps.json

Generated CLI Command Index

Generated from src/ts/developer-platform-cli/src at .

commands/auth.ts (commands)

  • login - Authenticate via browser
  • logout - Remove stored credentials
  • status - Show current authentication status

commands/config.ts (commands)

  • set - Set a configuration value
  • app <id> - Set the default app ID
  • api-url <url> - Set the API base URL (default: https://platform.archastro.ai)
  • portal-url <url> - Set the portal URL for authentication (default: https://developers.archastro.ai)
  • get - Get configuration values
  • app - Get the default app ID
  • api-url - Get the API base URL
  • portal-url - Get the portal URL for authentication
  • reset - Reset all configuration to defaults
  • path - Show config file location

commands/configs.ts (commands)

  • content <id> - Show configuration content
  • archive <id> - Archive a configuration
  • validate - Validate a configuration
  • kinds - List available config kinds
  • sample <kind> - Show a sample configuration for a kind
  • mv <fromPath> <toPath> - Update manifest mapping for a moved local config file
  • manifest-repair - Repair and normalize the local configs manifest
  • sync - Pull server configs to local directory
  • deploy - Push local configs to server in dependency order
  • edit <path> - Open a local config file in the browser editor
  • new [filename] - Create a new config file in the browser editor

commands/members.ts (commands)

  • invite - Invite a new team member
  • remove <id> - Remove a team member
  • invites - List pending invitations

index.ts (root)

  • resources - List all available resources and their supported verbs
  • console - Open the developer console in your browser

resources/agentinstallations.ts (resources)

  • agentinstallationkinds - List available installation kinds
  • agentinstallations - List installations for an agent
  • agentinstallation <id> - Show details for an installation
  • agentinstallation - Create a new installation for an agent
  • agentinstallation <id> - Delete an installation
  • agentinstallation <id> - Activate an installation

resources/agentroutineruns.ts (resources)

  • agentroutineruns - List runs for a routine

resources/agentroutines.ts (resources)

  • agentroutines - List routines for an agent
  • agentroutine <id> - Show details for a routine
  • agentroutine - Create a new routine for an agent
  • agentroutine <id> - Update a routine
  • agentroutine <id> - Delete a routine
  • agentroutine <id> - Activate a routine
  • agentroutine <id> - Pause a routine

resources/agents.ts (resources)

  • agents - List agents
  • agent <id> - Show agent details
  • agent - Create a new agent
  • agent <id> - Update an agent
  • agent <id> - Delete an agent

resources/appdomains.ts (resources)

  • appdomains - List domains
  • appdomain - Add a custom domain
  • appdomain <id> - Remove a custom domain

resources/appenvvars.ts (resources)

  • appenvvars - List environment variables
  • appenvvar <id> - Show details for an environment variable
  • appenvvar - Create a new environment variable
  • appenvvar <id> - Update an environment variable
  • appenvvar <id> - Delete an environment variable

resources/appkeys.ts (resources)

  • appkeys - List API keys
  • appkey - Create a new API key
  • appkey <id> - Revoke an API key

resources/appmembers.ts (resources)

  • appmembers - List team members
  • appmember <id> - Update a team member

resources/appoauthclients.ts (resources)

  • appoauthclients - List OAuth client registrations
  • appoauthclient <id> - Show details for an OAuth client registration
  • appoauthclient - Register a new OAuth client
  • appoauthclient <id> - Update an OAuth client registration
  • appoauthclient <id> - Delete an OAuth client registration

resources/appoauthproviders.ts (resources)

  • appoauthproviders - List OAuth providers
  • appoauthprovider <id> - Show details for an OAuth provider
  • appoauthprovider - Create a new OAuth provider
  • appoauthprovider <id> - Update an OAuth provider
  • appoauthprovider <id> - Delete an OAuth provider

resources/apps.ts (resources)

  • apps - List all apps
  • app <id> - Show app details

resources/appwebhooks.ts (resources)

  • appwebhooks - List webhooks
  • appwebhook <id> - Show details for a webhook
  • appwebhook - Create a new webhook
  • appwebhook <id> - Update a webhook
  • appwebhook <id> - Delete a webhook

resources/automationruns.ts (resources)

  • automationruns - List runs for an automation
  • automationrun <run-id> - Show details for an automation run

resources/automations.ts (resources)

  • automations - List automations
  • automation <id> - Show details for an automation
  • automation - Create a new automation
  • automation <id> - Update an automation
  • automation <id> - Delete an automation
  • automation <id> - Activate an automation
  • automation <id> - Pause an automation

resources/configs.ts (resources)

  • configs - List configurations
  • config <id> - Show details for a configuration
  • config - Create a new configuration
  • config <id> - Update a configuration

resources/contextcredentials.ts (resources)

  • contextcredentials - List context credentials
  • contextcredential <id> - Show details for a context credential
  • contextcredential - Create a new context credential
  • contextcredential <id> - Update a context credential
  • contextcredential <id> - Delete a context credential

resources/contextingestions.ts (resources)

  • contextingestions - List context ingestions
  • contextingestion <id> - Show details for a context ingestion

resources/contextintegrations.ts (resources)

  • contextintegrations - List context integrations
  • contextintegration <id> - Show details for a context integration
  • contextintegration - Create a new context integration
  • contextintegration <id> - Update a context integration
  • contextintegration <id> - Delete a context integration

resources/contextitems.ts (resources)

  • contextitems - List context items
  • contextitem <id> - Show details for a context item
  • contextitem <id> - Delete a context item

resources/contextsources.ts (resources)

  • contextsources - List context sources
  • contextsource <id> - Show details for a context source
  • contextsource - Create a new context source
  • contextsource <id> - Update a context source
  • contextsource <id> - Delete a context source

resources/custom-objects.ts (resources)

  • custom-objects - List custom objects
  • custom-object <id> - Show details for a custom object
  • custom-object - Create a new custom object
  • custom-object <id> - Update a custom object
  • custom-object <id> - Delete a custom object

resources/files.ts (resources)

  • files - List files
  • file <id> - Show details for a file (includes download URL)
  • file - Create a file from base64-encoded data
  • file <id> - Update a file

resources/personatemplates.ts (resources)

  • personatemplates - List persona templates
  • personatemplate <id> - Show persona template details
  • personatemplate - Create a new persona template
  • personatemplate <id> - Update a persona template
  • personatemplate <id> - Delete a persona template

resources/sandboxes.ts (resources)

  • sandboxes - List sandboxes
  • sandbox <id> - Show sandbox details
  • sandbox - Create a new sandbox
  • sandbox [id] - Switch to a sandbox (re-authenticates to get a sandbox-scoped token)

resources/sandboxkeys.ts (resources)

  • sandboxkeys - List keys for a sandbox
  • sandboxkey - Create a new sandbox key
  • sandboxkey <id> - Revoke a sandbox key

resources/sandboxmails.ts (resources)

  • sandboxmails - List captured emails in a sandbox
  • sandboxmail <id> - Show a captured sandbox email
  • sandboxmail [id] - Delete a sandbox email, or all emails if no ID given

resources/teams.ts (resources)

  • teams - List teams
  • team <id> - Show team details
  • team - Create a new team
  • team <id> - Update a team
  • team <id> - Delete a team

resources/threadmessages.ts (resources)

  • threadmessages - List messages in a thread
  • threadmessage <message-id> - Show details for a message

resources/threads.ts (resources)

  • threads - List threads
  • thread <id> - Show thread details

resources/userportalsessions.ts (resources)

  • userportalsession

resources/users.ts (resources)

  • users - List users
  • user <id> - Show user details
  • user - Create a new user
  • user <id> - Delete a user

resources/usertokens.ts (resources)

  • usertokens - List tokens for a user
  • usertoken - Create a token for a user
  • usertoken <token-id> - Revoke a user token