← Back to Docs

AI Agent Tools

Reference

AI Agent Tools

The Priiism AI agent has access to 76 specialized tools that let it manage your entire project lifecycle. You can trigger any of these by asking the agent in natural language.

Deployment Tools

ToolWhat It DoesParameters
priiism_deploy_webDeploy the current project to production hosting. Returns deployment status and URL. The project must have a viiibin.config.json with a web or static target.None
priiism_deploy_statusGet the status of recent deployments for this project. Returns deployment history with status, URLs, and timestamps.limit
priiism_deploy_logsGet build logs for a specific deployment. Returns the build output including install, build, and deploy stages.deploymentId (required)
priiism_deploy_cancelCancel an in-progress deployment. Only works for deployments that are currently building.deploymentId (required)
priiism_deploy_rollbackRoll the project’s live web deployment back to a prior successful deployment. Idempotent — rolling back to the same deployment twice is a no-op. Returns { deploymentId, status }.deploymentId (required)

Database Tools

ToolWhat It DoesParameters
priiism_db_queryExecute a SQL query against the project’s database. Supports SELECT, INSERT, UPDATE, DELETE, and DDL statements. Use parameterized queries with the params array for user-supplied values. Results are truncated at 1000 rows.sql (required), params
priiism_db_schemaGet the database schema for the project’s database. Returns table names with column definitions (name, type, notnull, primary key, default value). Specify a table name to get schema for a single table, or omit to get all tables.table
priiism_db_provisionProvision a database for this project. If a database is already provisioned, returns the existing database info. Call this before using db_query or db_schema if the project doesn’t have a database yet.None

Environment Variable Tools

ToolWhat It DoesParameters
priiism_env_listList all environment variables for the project. Secret values are masked. Returns variable names, environments, and whether they are secrets.None
priiism_env_setCreate or update an environment variable for the project. Keys must be SCREAMING_SNAKE_CASE.key (required), value (required), isSecret, environment (development
priiism_env_deleteDelete an environment variable by key. Specify the key and optionally the environment (default: development).key (required), environment (development

GitHub Tools

ToolWhat It DoesParameters
priiism_github_statusGet the GitHub repository connection status for this project. Returns whether a repo is linked, the repo name, and sync status.None
priiism_github_pushPush the current project files to the connected GitHub repository. Creates a commit with all project files. Requires GitHub to be connected and a repo linked in project settings.commitMessage, branch
priiism_github_pullPull the latest files from the connected GitHub repository into the project. Overwrites local files with the repo contents. Requires GitHub to be connected and a repo linked in project settings.branch
priiism_github_issues_listList GitHub issues for a repository. Defaults to the project’s linked repo, or specify a different repo. Returns issue number, title, state, labels, assignees, and URLs.repo, state (open
priiism_github_issue_createCreate a new GitHub issue. Defaults to the project’s linked repo, or specify a different repo.title (required), body, labels, assignees, milestone, repo
priiism_github_issue_updateUpdate an existing GitHub issue. Can change title, body, state (open/close), labels, assignees, and milestone.issue_number (required), title, body, state (open
priiism_github_issue_commentAdd a comment to a GitHub issue or pull request.issue_number (required), body (required), repo
priiism_github_pr_listList pull requests for a repository. Defaults to the project’s linked repo.repo, state (open
priiism_github_pr_createCreate a new pull request. Requires head and base branches. The head branch must already be pushed to GitHub.title (required), body, head (required), base (required), draft, repo
priiism_github_pr_mergeMerge a pull request. The PR must be mergeable (no conflicts, checks passing if required).pull_number (required), merge_method (merge
priiism_github_pr_reviewSubmit a review on a pull request. Can approve, request changes, or leave a comment.pull_number (required), body, event (APPROVE
priiism_github_repos_listList GitHub repositories accessible to the user. Does not require a linked project repo.type (all
priiism_github_branches_listList branches for a repository. Defaults to the project’s linked repo.repo, per_page, page
priiism_github_searchSearch GitHub code or issues. For code search, results are automatically scoped to the user’s accessible repos unless the query includes a “repo:” qualifier.q (required), type (code
priiism_github_milestones_listList milestones for a repository. Returns milestone number, title, description, state, issue counts, and due date.repo, state (open
priiism_github_milestone_createCreate a new milestone for a repository. Milestones group issues and PRs for tracking progress.title (required), description, due_on, state (open
priiism_github_milestone_updateUpdate an existing milestone. Can change title, description, due date, or state (open/close).milestone_number (required), title, description, due_on, state (open
priiism_github_labels_listList all labels for a repository. Returns label name, color, and description.repo, per_page, page
priiism_github_label_createCreate a new label for a repository.name (required), color, description, repo

Project Tools

ToolWhat It DoesParameters
priiism_container_statusGet the current container/sandbox status including dev server readiness, uptime, and tunnel URL.None
priiism_preview_urlGet the live preview URL for this project. Returns the tunnel URL that serves the running dev server.None
priiism_project_infoGet project metadata including name, description, status, template, and timestamps.None
priiism_config_getRead the viiibin.config.json for this project. This config file is REQUIRED for deployments. Returns the parsed config or an error if missing. The config schema is: { version: 1, name: string, description?: string, targets: Array, configVariables?: Record<string, ConfigVariable>, configFiles?: Array, postCreate?: { install?, migrate?, seed? } }. Target types: “web” (build-based web deploy, fields: buildCommand?, outputDir?), “static” (no build, fields: buildCommand?, outputDir?), “serverless” (fields: entryPoint?, routes?), “capacitor-ios” (fields: bundleId required, appName?, webDir?, minIosVersion?), “capacitor-android” (fields: bundleId required, appName?, webDir?, minSdkVersion?, targetSdkVersion?).None
priiism_config_setWrite/update the viiibin.config.json for this project. This config is REQUIRED for deployments. You must provide the full config object. Minimal example for a static site: { “version”: 1, “name”: “My App”, “targets”: [{ “type”: “static”, “name”: “web” }] }. For a build-based site: { “version”: 1, “name”: “My App”, “targets”: [{ “type”: “web”, “name”: “web”, “buildCommand”: “npm run build”, “outputDir”: “dist” }] }.config (required)
priiism_file_readRead the text content of a single project file by its path (relative to the project root, e.g. “src/index.ts”). Reads from durable project storage (archive-aware), so it works without a running sandbox. Returns the path and content, or an error if the file does not exist.path (required)
priiism_file_writeCreate or overwrite a single project file with the given text content. Writes to durable project storage and tracks the file in the project. The path is relative to the project root. Overwrites existing files.path (required), content (required)
priiism_file_listList the paths of all files in the project (relative to the project root). Optionally filter to a path prefix. Returns an array of file paths.prefix
priiism_file_deleteDelete a single project file by its path (relative to the project root). Returns an error if the file does not exist.path (required)
priiism_project_listList all projects in the authenticated organization (excluding deleted ones). Returns an array of projects with id, name, slug, description, status, templateId, and timestamps. The organization is taken from the API key/token — you do not pass it.None
priiism_project_createCreate a new project in the authenticated organization. Provide a name; optionally a description, a templateId to scaffold from a template (omit or use ‘empty’ for a blank project), and configValues supplying that template’s configuration variables. Returns the created project (and fileCount when a template populated files).name (required), description, templateId, configValues
priiism_project_updateUpdate an existing project’s name and/or description. Identify the target project by projectId. At least one of name or description must be provided. Returns the updated project.projectId (required), name, description
priiism_template_listList the active project templates available to the authenticated organization. Returns an array of templates with id, name, description, category, and isFeatured.None
priiism_template_instantiateCreate a new project from a template. Provide the templateId to instantiate and a projectName for the new project; optionally configValues supplying the template’s configuration variables. Returns the created project (and fileCount when the template populated files).templateId (required), projectName (required), configValues
priiism_actions_listList the pending AI actions awaiting approval for this project. Optionally filter by status (defaults to “pending”). Returns an array of pending actions with id, toolName, description, impact, category, status, and batch grouping.status (pending
priiism_action_approveApprove a single pending action by its id. Optionally set execute to run it immediately after approval. Returns the action id and, when executed, the execution result. Fails if the action is not currently pending.actionId (required), execute
priiism_action_rejectReject a single pending action by its id, with an optional reason. Fails if the action is not currently pending.actionId (required), reason
priiism_action_batchApprove or reject every still-pending action in a batch by its batchId. Returns the batchId, the decision, and the number of actions resolved (0 on a retry after the batch is already resolved).batchId (required), decision (required; approve
priiism_job_estimateEstimate the credit + dollar cost of delivering one or more milestones. Provide either a milestoneUrl, or a repo (“owner/name”) plus a milestones array of milestone numbers (or selectAll to estimate every open milestone). Returns a per-milestone cost breakdown and an aggregate total. Read-only — computes an estimate without queuing anything.milestoneUrl, repo, milestones, selectAll
priiism_job_executeRelease a queued job for pickup by the background delivery runner. Returns 202 with the job id and queued status — it does NOT run the job synchronously; poll job_status for progress. Fails if the platform is not configured to run jobs.jobId (required)
priiism_job_statusGet one job plus its per-issue work items (ordered by execution order). Returns the job record and its items array.jobId (required)
priiism_job_pausePause a running job. Returns the job id and its new paused status. Fails if the job is not currently running.jobId (required)
priiism_job_resumeResume a paused job, optionally raising its cost or token budget. Returns the job id and its new running status. Fails if the job is not currently paused.jobId (required), newCostLimit, newTokensLimit
priiism_plan_proposeKick off a planner run against the project’s latest succeeded knowledge build. Returns the newly-created pending/running proposal, or a 409 with the existing in-flight proposal if one is already running. Optionally pass a model to override the default.model
priiism_plan_dryrunRun a reconcile preview for a proposal against the linked repository without writing to it. Returns the decision list (which milestones/issues would be created, attached, suffixed, or skipped) plus the judgement cost. Read-only.proposalId (required)
priiism_plan_pushApply a proposal to the linked repository: create or attach milestones and issues. Supports perMilestoneOverrides to force a per-milestone policy (create/attach/suffix/skip). Partial pushes leave the proposal un-pushed so a retry re-attempts only the missing items.proposalId (required), perMilestoneOverrides
priiism_proposals_listList the plan-proposal history for this project (paginated). Optionally pass limit and an opaque cursor. Returns the proposals array and a nextCursor.limit, cursor
priiism_security_scanRun a security scan over the project’s current files: static analysis (SAST) plus a dependency-vulnerability audit. Persists a scan record and returns { scanId, status, score, findingsCount, criticalCount, highCount }. Each call runs a fresh scan.None
priiism_security_findingsList security findings from the most recent scans, newest first. Optionally filter by status (“open""resolved"
priiism_domain_bindBind a verified custom domain to the project’s live web hosting. The domain must already be verified (call domain_verify first) — binding an unverified domain returns a 409. Returns the updated domain record.domainId (required)
priiism_domain_verifyCheck whether a custom domain’s ownership DNS record is in place and, if so, transition it to verified. Returns { verified, domain }.domainId (required)
priiism_domain_statusPoll the live status of every custom domain on the project (refreshing each from the hosting platform) and return the current domain list. Read-only.None
priiism_identity_getRead the project’s managed identity-provider configuration: provider, provisioning status, callback URLs, allowed logout URLs, and web origins. Never returns the provider client secret. Read-only.None
priiism_identity_configureProvision or update the project’s managed identity-provider configuration (callback URLs, web origins, optional logout URLs). Upserts — safe to call repeatedly. Returns the same shape as identity_get.provider (required), callbackUrls (required), webOrigins (required), allowedLogoutUrls
priiism_conversations_listList the project’s chat conversations (id, title, createdAt), newest first. Optionally pass limit (default 20, max 100). Read-only.limit
priiism_org_members_listList the members of the API key’s organization (userId, email, name, role). Read-only.None
priiism_autonomy_startDANGEROUS — requires the opt-in autonomy:run scope, which is OFF by default and is NEVER included in any role bundle; a key must carry it explicitly. Starts the autonomous multi-step agent loop for the project’s latest succeeded plan proposal (or an explicit proposalId). This SPENDS credits and opens real pull requests. If a run is already in progress for the resolved proposal, returns a 409 with the existing runId instead of starting a duplicate.proposalId, stepMode
priiism_autonomy_statusRead the status of an autonomous run: returns the plan_autonomy_runs row plus the most recent plan_node_runs for the run’s proposal. Read-only. Requires the autonomy:read scope.runId (required)
priiism_seos_roles_listList the project’s SEOS engineering-role charters (worker/reviewer/release/lead tiers and their owned levers). Read-only. Requires the autonomy:read scope.None
priiism_container_execDANGEROUS — requires the opt-in container:exec scope, which is OFF by default and is NEVER included in any role bundle; a key must carry it explicitly. Runs an arbitrary shell command in the project’s active sandbox. The command is validated against the platform command allowlist BEFORE execution — blocked commands (e.g. rm -rf /) return an error and never run. Returns { stdout, stderr, exitCode } with each stream truncated at 10,000 characters.command (required), timeout, workdir
priiism_code_searchDANGEROUS — requires the opt-in code:search scope, which is OFF by default and is NEVER included in any role bundle; a key must carry it explicitly. Runs a RAG semantic search over the whole project’s indexed codebase and returns the most relevant chunks (filePath, content, score, startLine, endLine).query (required), topK, minScore

Mobile Build Tools

ToolWhat It DoesParameters
priiism_signing_statusCheck iOS and Android signing credential status for this project. Returns whether credentials are configured for each platform, along with team name (iOS) or package name (Android).None
priiism_trigger_mobile_buildTrigger a mobile build (iOS or Android) in the cloud. Requires signing credentials to be configured for signed builds. Returns a build ID to track progress. NOTE: This action requires user confirmation before executing.platform (required; ios
priiism_mobile_build_statusCheck the status of a mobile build. Returns build ID, status, platform, timestamps, and artifact URL if available.buildId (required)
priiism_mobile_build_logsGet logs from a mobile build. Returns the build output including install, build, and signing stages.buildId (required)
priiism_signing_credentials_setCreate or update the project’s mobile signing credentials for one platform. Pass platform ‘ios’ with the App Store Connect API key fields, or platform ‘android’ with the keystore fields. A second call for the same platform updates in place. The response is a MASKED summary — raw keys/keystores are never returned.platform (required), name (required), ascIssuerId, ascKeyId, ascPrivateKey, bundleId, keystoreBase64, keystorePassword, keyAlias, keyPassword, packageName, buildType

Code Tools (Built-in)

The agent also has standard coding tools:

ToolWhat It Does
readRead file contents
writeCreate or overwrite a file
editMake targeted edits to a file
bashRun shell commands in the sandbox
globFind files by pattern
grepSearch file contents

Example Prompts

Here are some prompts that trigger these tools:

  • “Deploy my app to production” → priiism_deploy_web
  • “Create a users table with name and email columns” → priiism_db_provision + priiism_db_query
  • “Push my changes to GitHub with message ‘Add login page’” → priiism_github_push
  • “Create an issue for the login bug” → priiism_github_issue_create
  • “Set API_KEY to sk-123 as a secret” → priiism_env_set
  • “Build the iOS app for TestFlight” → priiism_trigger_mobile_build
  • “What tables are in my database?” → priiism_db_schema