Use Nitejar
Tools Built-in tools available to Nitejar agents, grouped by what operators expect them to do.
Nitejar agents interact with the world through tools. Each tool is a discrete capability the agent can invoke during a run. Tools are registered by the platform and optionally by plugins.
This page is organized by operator-facing purpose rather than by internal module names, because the important question is not "which file registered this?" but "what kind of work does this let an agent do?"
Where to verify
Open Agents > [agent] to see which tools are enabled for a specific agent. Disabled tools are
hidden from the agent's prompt and cannot be called.
Tool availability is not universal. Some tools are gated by agent configuration, role policy, credentials, feature flags, or granted platform access.
Plugin assignment and tool access are different things. A plugin can connect an agent to a channel without granting every possible outbound operation in that domain.
Some tools act on the agent's own state. Others inspect or manage broader fleet or platform objects. Treat those as policy-sensitive capabilities.
Tool Description Key Parameters bash Execute shell commands in the agent's sandbox. command, working_directory, timeoutread_file Read file contents with line numbers. path, start_line, max_lineswrite_file Write content to a file. path, contentlist_directory List directory contents with file type indicators. pathcreate_directory Create a directory, including parents. pathedit_file Perform surgical string replacement in a file. path, old_string, new_stringuse_skill Resolve a skill into its sandbox path and file listing. name
Tool Description Key Parameters create_service Create a managed long-running service inside the sandbox. name, command, http_portlist_services List services with status, PID, and uptime. -- manage_service Start, stop, or delete a named service. name, actionget_sprite_url Return the public URL for routing traffic to the agent's sprite. -- start_background_task Start a detached background task in the sandbox. task payload check_background_task Check progress or output for a background task. task_idlist_background_tasks List known background tasks. -- stop_background_task Stop a background task. task_idlist_sandboxes List available sandboxes. -- switch_sandbox Switch the active sandbox. sandbox_idcreate_ephemeral_sandbox Create a temporary isolated sandbox. -- delete_sandbox Delete a sandbox and its contents. sandbox_id
Tool Description Key Parameters add_memory Store a long-term memory. content, pinnedremove_memory Delete a memory by ID or matching content. id or contentupdate_memory Update a memory with concurrency protection. id, content, versiondefine_collection Propose a new collection schema. name, fieldscollection_list_reviews List pending collection reviews. review filters collection_review_schema Approve or reject a proposed collection schema. review payload collection_update_permission Update collection access posture. permission payload collection_update_schema Evolve an existing collection schema. schema payload collection_describe Inspect a collection definition and its fields. collectioncollection_query Query rows by metadata filters and sort order. collection, filterscollection_search Full-text search across collection content. collection, querycollection_get Get a single row by ID. collection, idcollection_insert Insert rows into a collection. collection, rowscollection_upsert Upsert rows into a collection. collection, rows
Tool Description Key Parameters schedule_check Schedule a deferred check-in for the current agent. minutes, contextlist_schedule List pending scheduled items for the current agent. -- cancel_scheduled Cancel a pending scheduled item. idcreate_routine Create a recurring automated run. routine payload list_routines List routines visible to the agent. filters get_routine Inspect one routine. routine id update_routine Update routine configuration. routine id and fields pause_routine Pause a routine. routine id delete_routine Delete a routine. routine id run_routine_now Trigger a routine immediately. routine id
Tool Description Key Parameters web_search Search the web and return ranked results. query, time_range, domainsextract_url Extract one or more URLs as markdown. urls, chunkgenerate_image Create images when image generation is enabled. image prompt payload transcribe_audio Transcribe audio when speech-to-text is enabled. audio input payload synthesize_speech Generate audio when text-to-speech is enabled. speech payload download_attachment Download and inspect inbound attachments. attachment_id
Tool Description Key Parameters search_goals Search goals by status, owner, health, or text. goal filters search_tickets Search tickets by status, owner, or text. ticket filters get_ticket Inspect one ticket in detail. ticket id claim_ticket Claim a ticket for the current agent. ticket id assign_ticket Assign a ticket. ticket id and assignee update_ticket Update ticket status or other mutable fields. ticket payload post_ticket_comment Add a comment to a ticket. ticket id and comment post_work_update Post a work update or heartbeat-style progress note. goal/ticket payload link_ticket_receipt Attach a receipt or reference back to a ticket. ticket id and receipt run_ticket_now Trigger immediate execution for a ticket. ticket id create_goal Create a new goal. goal payload delete_goal Delete a goal. goal id create_ticket Create a new ticket. ticket payload delete_ticket Delete a ticket. ticket id
Tool Description Key Parameters list_teams List teams visible to the agent. filters get_team Inspect a team. team id create_team Create a team when policy allows. team payload update_team Update a team. team id and fields delete_team Delete a team. team id list_roles List roles visible to the agent. filters get_role Inspect one role. role id create_role Create a role. role payload update_role Update a role. role id and fields delete_role Delete a role. role id assign_role Assign a role to an agent or team target. assignment payload unassign_role Remove a role assignment. assignment payload get_self_policy Inspect the current agent's effective policy posture. -- refresh_network_policy Refresh sandbox egress policy after config changes. --
Tool Description Key Parameters get_self_config Inspect the current agent's own configuration. -- list_agents List agents visible to the caller. filters get_agent_config Inspect another agent's configuration. agent id get_agent_soul Read an agent's soul prompt. agent id create_agent Create an agent when policy allows. agent payload set_agent_status Change agent status. agent id and status delete_agent Delete an agent. agent id update_agent_config Update agent configuration. agent id and config update_agent_soul Update an agent soul prompt. agent id and content list_plugin_instances List plugin instances. filters get_plugin_instance Inspect one plugin instance. plugin instance id set_plugin_instance_agent_assignment Attach or detach an agent from a plugin instance. assignment payload
Tool Description Key Parameters list_credentials List credentials visible to the agent. filters secure_http_request Make an authenticated HTTP request using stored credentials. request payload configure_github_credentials Mint a short-lived GitHub App installation token and configure sandbox Git auth for an allowed repository. repo_name, duration
Tool Description Key Parameters query_activity Search the cross-agent activity log. query, agent_id, status, max_agelist_runs List prior runs visible to the current agent. run filters and pagination get_run Inspect one prior run in detail. run id plus detail options run_todo Manage the run-local todo list used during agent execution. action, items
Plugins can contribute additional tools through the PluginProvider interface. When a plugin registers a provider, its tools appear alongside the built-in tools in the agent's prompt and in the app's tools list.
export default definePlugin ({ handler, provider: { tools: [ { name: 'jira_create_issue' , description: 'Create a Jira issue' , parameters: { /* JSON Schema */ }, execute : async ( params , context ) => { /* ... */ }, }, ], }, }) Plugin tools follow the same enable or disable rules as built-in tools. They are toggled per-agent from Agents > [agent] .
For details on building plugins, see the Plugin SDK documentation .
Important scope rules Execution & Filesystem Services, Background Tasks, & Sandboxes Knowledge, Memory, & Collections Scheduling & Routines Research, Web, & Media Work Management Teams, Roles, & Policy Platform Control & Self-Inspection Credentials & GitHub Auth Activity, Receipts, & Run History Plugin-contributed tools 
Nitejar Docs