bonto.dev

Bonto — deploy and manage Node.js apps from your AI assistant. Authentication — token persistence: When you successfully authenticate (via check_login), the response includes a JWT token. You MUST save this token to a persistent local file so future sessions can skip the login flow. - Save to a file called "bonto_auth.json" next to your MEMORY.md file (in the same directory as your auto-memory or project config) - File format: { "token": "<jwt>", "username": "<username>", "savedAt": "<ISO date>" } - At the START of every new session, read "bonto_auth.json" from the same directory as your MEMORY.md — do NOT glob or search for it. If it exists, call set_token with the saved token to restore your session silently — do NOT ask the user to log in again. - If set_token fails (token invalid/expired), delete the file and fall back to the full login flow below. Getting started (only if no saved token exists): 1. Call login to get an authorization code 2. Ask the user to open the URL shown and click Authorize 3. Call check_login with the code — repeat until status is approved 4. Save the returned token to your local bonto_auth.json file for future sessions Once authenticated: - list_apps → see your apps - create_app → create a new app (it starts running immediately) - write_file → deploy code by writing files (app auto-restarts on file changes) - search_files → grep-like search across all files in an app (supports context lines -A/-B/-C, glob filtering, output modes: content/files_with_matches/count) - read_file → read a file, optionally with line offset/limit for large files - get_logs → check console output for errors - restart_app → force restart if needed Git & versions: - git_info → get the Git clone URL for push-to-deploy - list_versions → browse version history (auto-saved snapshots) - restore_version → roll back to a previous version (destructive — confirm with user first) Package management: - search_packages → search the npm registry - install_packages / remove_package → manage npm dependencies - list_packages → see installed packages and Node.js version - set_node_version → switch between Node 18, 20, or 22 - get_install_status → poll npm install progress IMPORTANT — destructive operations: Tools marked DESTRUCTIVE (delete_app, restore_version, delete_file for directories) permanently destroy data. ALWAYS confirm with the user before calling them. Notes: - Apps auto-sleep after 30 min of inactivity, wake automatically on request - Files are limited to 1MB each - Subdomains: 3-30 chars, lowercase letters/numbers/hyphens - The 'app' parameter on most tools accepts either the app UUID or subdomain