Tools

Built-in Tools

Open Astra ships with 67 built-in tools. All are available to any agent subject to the agent's allow/deny policy.

File System

ToolDescription
file_readRead the contents of a file at a given path
file_writeWrite content to a file, creating it if it does not exist
file_appendAppend content to an existing file
file_deleteDelete a file or directory
file_listList files in a directory with optional glob filtering
file_searchSearch for files matching a pattern recursively

Shell and Process

ToolDescription
shell_execExecute a shell command and return stdout/stderr
shell_exec_longExecute a long-running command with streaming output
process_listList running processes

Web and HTTP

ToolDescription
web_searchSearch the web via Brave Search API and return summarized results
web_fetchFetch the content of a URL and return its text
http_requestMake an arbitrary HTTP request (GET, POST, PUT, DELETE)
graphql-queryExecute a GraphQL query or mutation with optional variables, custom headers, and schema introspection

Code

ToolDescription
code_searchSearch the codebase using ripgrep-style patterns
codebase_indexIndex the codebase for semantic search queries
codebase_searchSemantic search over indexed codebase chunks
git_commandRun any git command and return its output
git_diffGet the diff for staged, unstaged, or a specific commit

Memory

ToolDescription
memory_writeWrite a fact or note to the user's personal memory (Tier 2)
memory_searchSearch across all memory tiers for a query
workspace_memory_writeWrite a team-scoped entry to workspace memory
workspace_memory_searchSearch workspace memory entries
workspace_knowledge_writeWrite an entry to the structured knowledge base
workspace_knowledge_searchSearch the knowledge base
graph_writeWrite an entity or relationship to the knowledge graph
graph_traverseTraverse the knowledge graph from a seed entity
document_searchSearch uploaded RAG documents by semantic similarity
memory_compressOn-demand tier-specific memory compression with diff output
memory_propagateHierarchical cross-tier promotion of memory entries
memory_budgetPer-agent memory access limits with enforcement
consistency_checkCross-tier contradiction detection across memory layers
memory_feedbackPost-synthesis utility feedback for memory retrieval tuning
relation_decayManual time-based graph edge strength decay management

Agents and Orchestration

ToolDescription
spawn_agentSpawn a sub-agent with a task and shared blackboard context
blackboard_writeWrite a value to the swarm blackboard
blackboard_readRead a value from the swarm blackboard
blackboard_listList all keys on the current swarm blackboard
blackboard_topicNamed pub/sub channels for selective swarm communication
code_review_swarmMulti-agent autonomous code review with specialized reviewers
swarm_observeRead-only swarm monitoring with alerts
meta_controllerMulti-swarm overseer with resource allocation
debate_witnessEvidence retrieval from memory for conflict resolution

Session and Scenario

ToolDescription
session_branchFork sessions into parallel experiment branches
scenario_engineWhat-if simulation with side-by-side comparison

Multi-Modal and Routing

ToolDescription
multimodal_inputUnified multi-modal input processing (text, image, audio)
provider_routeCross-provider intelligent routing based on task requirements
model_inferenceDirect model inference call with full parameter control (temperature, top-p, stop sequences)

Deep Research and Dream Mode

ToolDescription
research_manageStart, iterate, and retrieve results from long-running deep research tasks
dream_manageTrigger and retrieve results from dream mode offline simulation sessions

Database

ToolDescription
database_queryExecute parameterized queries against the connected Postgres database
graph_schema_evolutionAdd, modify, or deprecate knowledge graph entity and edge types

Agent Self-Improvement

ToolDescription
ethical_checkPost-generation ethical alignment validation with category scoring
agent_therapySelf-reflection journal and behavioral pattern analysis
health_scorecardPeriodic agent reliability and efficiency scoring
evolution_feedbackGoal-driven persona evolution with feedback loops

Workspace

ToolDescription
prompt_templateVersioned reusable prompt templates
knowledge_injectExternal knowledge injection with deduplication

Utilities

ToolDescription
result_summarizerSummarize a long piece of text to fit within a token budget
calculatorEvaluate mathematical expressions safely
date_timeGet current date and time in any timezone
json_transformApply jq-style transformations to JSON data
text_diffCompute a readable diff between two strings
pdf_readExtract text content from a PDF file or URL