> ## Documentation Index > Fetch the complete documentation index at: https://www.siya.com/llms.txt > Use this file to discover all available pages before exploring further. # Tools & Capabilities > Comprehensive reference of all tools and capabilities available in Siya Siya comes equipped with a comprehensive set of tools that enable it to interact with files, systems, web services, and more. These tools are what allow Siya's agents to turn ideas into reality. ## Tool Categories Overview ```mermaid theme={null} mindmap root((Siya Tools)) File System Read Files Write Files Edit Files Search Files Directory Operations Code & Development Code Generation Syntax Analysis Testing Debugging Version Control Web & Network Web Search API Calls Web Scraping Browser Automation HTTP Requests Data & Analysis Data Processing Visualization Statistical Analysis Report Generation Format Conversion System & Automation Command Execution Process Management Scheduling Monitoring Integration AI & Intelligence Model Selection Context Management Memory Operations Learning Patterns Optimization ``` ## File System Tools Powerful file reading capabilities with intelligent format detection Read any text-based file with automatic encoding detection Smart pagination for files with thousands of lines Identifies and handles binary files appropriately * **Images**: Extracts metadata and can describe content * **Audio**: Transcribes to text using speech recognition * **Jupyter**: Reads notebooks as structured JSON ```text Simple Read theme={null} "Read the config.json file" ``` ```text With Line Range theme={null} "Read lines 100-200 of app.log" ``` ```text Multiple Files theme={null} "Read all Python files in the src directory" ``` **Pattern Matching** * Find files by name patterns * Recursive directory search * Multiple pattern support * Exclude patterns **Content Search** * Regex pattern matching * Case sensitivity options * Context lines * File type filtering For complex searches, Siya automatically uses ripgrep (rg) for superior performance
Operation Description Example
List (LS) Show directory contents "List all files in /src"
Tree View Hierarchical structure "Show project structure"
Find Locate files/directories "Find all test files"
Safe and intelligent file creation and modification The Write tool always reads existing files first to prevent accidental overwrites **Capabilities:** * Create new files with any extension * Overwrite existing files (with confirmation) * Automatic directory creation * Encoding specification * Permission handling Always checks if file exists before writing Creates parent directories if needed Maintains proper line endings and encoding Makes exact string replacements while preserving file structure **Features:** * Exact string matching * Indentation preservation * Multi-line support * Batch replacements * Undo capability For multiple edits to the same file, use MultiEdit for better performance ```mermaid theme={null} flowchart LR File[Original File] --> Edit1[Edit 1] Edit1 --> Edit2[Edit 2] Edit2 --> Edit3[Edit 3] Edit3 --> Result[Updated File] style File fill:#f9f,stroke:#333 style Result fill:#9f9,stroke:#333 ``` **Advantages:** * Atomic operations (all or nothing) * Sequential edit application * Better performance * Reduced error potential * Single file read/write * Single files * Directories * Pattern matching * Preserve attributes * Rename files * Relocate directories * Batch operations * Cross-filesystem * Safe deletion * Recursive removal * Pattern matching * Trash support Change file permissions, ownership, and access controls Read creation dates, modification times, file sizes Set executable flags, hidden attributes, system properties ## Code & Development Tools Comprehensive tools for software development, from code generation to deployment
**Web Technologies** * HTML/CSS/JavaScript * TypeScript * React/Vue/Angular * Node.js * Next.js/Nuxt
**Backend Languages** * Python * Java/Kotlin * C#/.NET * Go * Rust * Ruby
**Specialized** * SQL/NoSQL queries * GraphQL schemas * Protocol Buffers * Configuration files * Shell scripts
Generate project structures, starter templates, and scaffolding Create complete functions with error handling and documentation Design and implement classes with proper patterns and principles Build REST/GraphQL APIs with authentication and validation Create comprehensive test suites with mocks and fixtures * SOLID principles * Design patterns * Clean code * DRY/KISS * Documentation * Performance tuning * Memory efficiency * Algorithm selection * Caching strategies * Async patterns ```mermaid theme={null} graph TD Tests[Test Suite] --> Unit[Unit Tests] Tests --> Integration[Integration Tests] Tests --> E2E[End-to-End Tests] Tests --> Performance[Performance Tests] Unit --> Coverage[Code Coverage] Integration --> API[API Testing] E2E --> UI[UI Testing] Performance --> Load[Load Testing] style Tests fill:#0000FF,stroke:#fff,color:#fff style Coverage fill:#4CAF50,stroke:#333 style API fill:#FF9800,stroke:#333 style UI fill:#9C27B0,stroke:#333 style Load fill:#F44336,stroke:#333 ``` **Test Frameworks:** * **JavaScript**: Jest, Mocha, Cypress, Playwright * **Python**: pytest, unittest, nose2 * **Java**: JUnit, TestNG, Mockito * **Go**: testing package, testify * **Ruby**: RSpec, Minitest Parse error messages and stack traces to identify root causes Analyze code flow and variable states Provide multiple solution approaches with trade-offs Recommend defensive coding practices Siya can simulate debugging sessions, walking through code execution step by step
**Profiling** * Time complexity analysis * Memory usage patterns * CPU utilization * I/O bottlenecks * Database query optimization
**Optimization** * Algorithm improvements * Caching implementation * Parallel processing * Lazy loading * Resource pooling
Complete version control capabilities without leaving Siya
**Basic Operations** * Status checking * Add/stage files * Commit with messages * Push/pull changes * Branch management
**Advanced Features** * Interactive rebase * Cherry-picking * Stash management * Submodule handling * Hook configuration
Siya always shows diffs before committing and includes co-author attribution Create, clone, and configure repositories Create PRs with detailed descriptions and test plans Create and update issues, link to PRs Set up CI/CD pipelines and automation Use `gh` CLI commands for advanced GitHub operations ## Web & Network Tools Access the web, interact with APIs, and automate online tasks * Multi-engine search * Result ranking * Source verification * Date filtering * Language support * Academic papers * Code repositories * Documentation * News articles * Social media Search results are automatically verified and cross-referenced for accuracy ```mermaid theme={null} flowchart LR Query[Search Query] --> Engine{Search Engine} Engine --> Results[Raw Results] Results --> Filter[Filtering] Filter --> Verify[Verification] Verify --> Rank[Ranking] Rank --> Summary[Summarization] Summary --> Output[Final Report] style Query fill:#FF9800,stroke:#333 style Output fill:#4CAF50,stroke:#333 ``` **Advanced Features:** * Citation tracking * Fact verification * Trend analysis * Competitive intelligence * Market research ```http GET Request theme={null} GET /api/users Headers: Authorization: Bearer token ``` ```http POST Request theme={null} POST /api/users Content-Type: application/json Body: {"name": "John", "email": "john@example.com"} ``` ```http Complex Request theme={null} PUT /api/users/123 Headers: Multiple custom headers Body: Multipart form data ``` **Supported Features:** * All HTTP methods * Header management * Authentication (OAuth, JWT, API keys) * Request/response transformation * Error handling and retries Test individual endpoints with various parameters Test complete API workflows and sequences Simulate multiple concurrent requests Generate API documentation from tests * Webhook reception * Payload validation * Event processing * Response generation * Event triggers * Payload construction * Retry logic * Delivery tracking Browser automation that sees and interacts with pages like a human would **Capabilities:** * Click buttons and links * Fill out forms * Navigate menus * Handle popups * Manage cookies * Take screenshots * Download files The Browser Agent uses computer vision for reliable element detection * Product searches * Cart management * Checkout processes * Order tracking * Price monitoring * Table scraping * Pagination handling * Dynamic content * Image extraction * PDF downloads * Login flows * 2FA handling * Session management * Token refresh * SSO integration ## Data & Analysis Tools Powerful data processing, analysis, and visualization capabilities * CSV/TSV * Excel (XLSX) * JSON * XML * Parquet * SQL queries * NoSQL operations * Data migration * Schema design * Indexing * Text extraction * PDF parsing * Log analysis * Email processing * Web scraping Remove duplicates, handle missing values, fix inconsistencies Standardize formats, scales, and representations Group, summarize, and calculate statistics Add calculated fields, join datasets, geocoding ```python theme={null} # Example transformation pipeline df = pd.read_csv('data.csv') df = df.drop_duplicates() df['date'] = pd.to_datetime(df['date']) df['revenue_usd'] = df['revenue'] * exchange_rate summary = df.groupby('category').agg({ 'revenue_usd': ['sum', 'mean', 'std'], 'quantity': 'sum' }) ```
**Descriptive Statistics** * Mean, median, mode * Standard deviation * Percentiles * Correlation * Distribution analysis
**Advanced Analytics** * Regression analysis * Time series * Clustering * Classification * Anomaly detection
Siya automatically selects appropriate statistical methods based on data characteristics ```mermaid theme={null} graph LR Data[Raw Data] --> Prep[Preparation] Prep --> Split[Train/Test Split] Split --> Train[Model Training] Train --> Eval[Evaluation] Eval --> Deploy[Deployment] Train --> Tune[Hyperparameter Tuning] Tune --> Train style Data fill:#f9f,stroke:#333 style Deploy fill:#9f9,stroke:#333 ``` **Supported Algorithms:** * Linear/Logistic Regression * Decision Trees/Random Forests * Neural Networks * SVM * K-Means/DBSCAN * Line plots * Bar charts * Scatter plots * Pie charts * Area charts * Heatmaps * 3D plots * Sankey diagrams * Network graphs * Geospatial maps * Dashboards * Drill-down charts * Real-time updates * Filters/controls * Animations **Python:** * Matplotlib * Seaborn * Plotly * Bokeh * Altair **JavaScript:** * D3.js * Chart.js * Highcharts * ECharts * Recharts Siya can generate code for any visualization library or create charts directly ## System & Automation Tools Powerful system interaction and task automation capabilities Commands are executed in a persistent shell session with safety checks **Features:** * Persistent shell state * Working directory management * Environment variables * Output capture (up to 30K chars) * Timeout protection (up to 10 min) * Sandbox mode for read-only ops ```bash Build Project theme={null} npm install && npm run build ``` ```bash System Info theme={null} df -h && free -m && uptime ``` ```bash Git Operations theme={null} git status && git diff --stat ``` Start, stop, and monitor system processes Track CPU, memory, disk, and network usage Tail logs, search patterns, rotate files Manage system services and daemons Sandbox mode runs commands without write access for safety
Operation Normal Mode Sandbox Mode
Read files ✅ ✅
Write files ✅ ❌
Network access ✅ ❌
User approval Required Not needed
Built-in task management for complex multi-step operations **Features:** * Automatic task creation * Status tracking (pending/in-progress/completed) * Priority levels * Dependencies * Progress visualization ```mermaid theme={null} stateDiagram-v2 [*] --> Pending Pending --> InProgress: Start InProgress --> Completed: Finish InProgress --> Pending: Pause Completed --> [*] InProgress --> InProgress: Update ``` * Time-based * File changes * Git commits * API webhooks * System events * Run scripts * Send notifications * Update databases * Generate reports * Deploy code ```text Cron-style theme={null} "0 9 * * 1-5" - Weekdays at 9 AM "*/30 * * * *" - Every 30 minutes "0 0 1 * *" - First day of month ``` ```text Natural Language theme={null} "Every Monday at 10 AM" "Daily at sunset" "Every 2 hours during business hours" ``` ```text Relative theme={null} "In 30 minutes" "Tomorrow at noon" "Next Friday" ``` Schedules persist across Siya sessions and system restarts * Nightly builds * Test suite runs * Dependency updates * Code backups * Documentation generation * Report generation * Data syncing * Backup creation * Cache clearing * Log rotation * Health checks * Performance metrics * Error alerts * Usage reports * Trend analysis ## AI & Intelligence Tools Tools for managing AI models, context, and learning patterns * Dynamic model switching * Task-based selection * Cost optimization * Performance tuning * Fallback chains * Token management * Context windowing * Memory prioritization * Relevance filtering * Compression strategies ```mermaid theme={null} graph TD Input[User Input] --> STM[Short-term Memory] STM --> Process[Processing] Process --> LTM{Long-term Memory?} LTM -->|Important| Store[Persistent Storage] LTM -->|Temporary| Discard[Auto-cleanup] Store --> Retrieve[Smart Retrieval] Retrieve --> Context[Active Context] style STM fill:#FFE082,stroke:#333 style Store fill:#81C784,stroke:#333 style Context fill:#64B5F6,stroke:#333 ``` **Memory Features:** * Auto-compacting * Semantic indexing * Priority weighting * Cross-session persistence * Privacy controls Track common patterns and preferences Improve response time and accuracy Adapt to individual working styles Accumulate domain expertise ## Tool Integration Patterns The real power comes from combining tools in intelligent ways ```mermaid theme={null} graph LR Glob[Glob: Find files] --> Read[Read: Load content] Read --> Process[Process: Transform] Process --> Write[Write: Save results] style Glob fill:#FF9800,stroke:#333 style Process fill:#0000FF,stroke:#fff,color:#fff style Write fill:#4CAF50,stroke:#333 ``` **Example Use Cases:** * Bulk file processing * Code refactoring * Data migration * Report generation Search agent gathers information from multiple sources Process and synthesize findings Generate formatted reports with visualizations * File changes * API endpoints * System metrics * Error logs * Email notifications * Slack messages * SMS alerts * Dashboard updates * Run scripts * Restart services * Scale resources * Create tickets ```mermaid theme={null} graph TD Git[Git: Detect Push] --> Test[Bash: Run Tests] Test --> Build{Build Success?} Build -->|Yes| Docker[Bash: Build Image] Build -->|No| Notify1[Alert: Build Failed] Docker --> Deploy[Bash: Deploy] Deploy --> Check[HTTP: Health Check] Check -->|Healthy| Notify2[Alert: Success] Check -->|Unhealthy| Rollback[Bash: Rollback] Rollback --> Notify3[Alert: Rolled Back] style Git fill:#F05032,stroke:#333 style Deploy fill:#0000FF,stroke:#fff,color:#fff style Notify2 fill:#4CAF50,stroke:#333 ``` **Automated ETL Process:** 1. **Extract**: Read from multiple sources (APIs, databases, files) 2. **Transform**: Clean, normalize, and enrich data 3. **Load**: Write to data warehouse or generate reports 4. **Monitor**: Track pipeline health and data quality 5. **Alert**: Notify on failures or anomalies Search for relevant information and sources Create structured content plan Write content with proper formatting Add images, diagrams, and references Deploy to website or documentation system ## Tool Safety & Best Practices With great power comes great responsibility. Follow these guidelines for safe tool usage. * Read before write * Confirmation prompts * Sandbox mode * Timeout limits * Resource caps * Approval requirements * Permission settings * Audit logging * Rollback capability * Emergency stop Test operations on sample data before running on production Run exploratory commands in sandbox to prevent accidents Always review diffs and changes before confirming Create backups before major operations Watch progress and be ready to intervene if needed
Pitfall Risk Prevention
Overwriting files Data loss Always read first, use version control
Infinite loops Resource exhaustion Set timeouts, monitor execution
Large operations System overload Batch processing, progress tracking
Credential exposure Security breach Use environment variables, never commit
## Performance Optimization Tips and strategies for optimal tool performance Group similar operations together for better efficiency Run independent operations simultaneously Reuse results and avoid redundant operations * Use glob patterns instead of individual reads * Batch edits with MultiEdit tool * Stream large files instead of loading entirely * Use efficient search tools (ripgrep) * Batch API requests when possible * Implement retry logic with backoff * Cache responses appropriately * Use connection pooling * Process in chunks for large datasets * Use appropriate data structures * Leverage vectorized operations * Implement early filtering ## Tool Troubleshooting
Issue Symptoms Solution
Tool timeout Operation stops after delay Increase timeout or break into smaller operations
Permission denied Cannot read/write files Check file permissions, run with appropriate access
Memory issues Slow performance or crashes Process data in chunks, clear unused memory
Network failures API calls fail Check connectivity, implement retries
Review tool-specific documentation and examples "Why did this tool fail?" or "How do I use X tool?" Check execution logs for detailed error information Reach out to [dev@siya.com](mailto:dev@siya.com) for persistent issues ## Summary Siya's comprehensive toolkit enables you to tackle any challenge. From simple file operations to complex multi-step workflows, these tools work together seamlessly to transform your ideas into reality. Start with basic operations and gradually explore advanced combinations to unlock unprecedented productivity. Learn how Siya plans and executes complex tasks Open Siya and experiment with different tools *** *Powerful tools. Seamless integration. Unlimited potential.*