Custom Operational Modes

Sypha enables the creation of Proprietary Modes, allowing you to fine-tune the assistant's behavior for niche tasks or specific organizational workflows. Custom personas can be established as Global (available across your entire environment) or restricted to a Specific Project.

Strategic Utility

• Functional Specialization: Develop specialized personas such as "Security Auditor," "Performance Specialist," or "QA Engineer."
• Asset Integrity: Implement restricted modes (e.g., "Read-Only Reviewer") that lack permission to modify sensitive source files or execute terminal commands.
• Controlled Experimentation: Safely iterate on behavioral prompts and logic constraints without impacting standard system modes.

Initializing a Custom Persona

You can establish new operational modes through three primary paths:

1. Collaborative Request

The most efficient method is to simply direct Sypha: "Create a new mode named 'Test Orchestrator' with access to terminal execution and a focus on Jest unit tests."

2. Dashboard Interface

1. Access the Prompts dashboard via the primary Sypha menu.
2. Select the + (New) icon adjacent to the Modes registry.
3. Define the Name, Slug (identifier), Role Logic, and the specific Tool Groups authorized for the mode.

3. Structural Configuration (YAML/JSON)

• Global Personas: Modify the custom_modes.yaml configuration (accessible through System Settings).
• Project Personas: Add a .syphamodes configuration file to your project root.

Configuration Schema Example

customModes:
    - slug: security-audit
      name: Security Auditor
      description: Focused on identifying vulnerabilities and enforcing safety standards.
      roleDefinition: You are a senior security researcher auditing code for OWASP compliance.
      groups:
          - read
          - - edit
            - fileRegex: \.security-report\.md$
              description: Audit reports only

Persona-Specific Rule Sets

You can provide granular instructions for your custom modes by utilizing dedicated rule directories:

• Project-Level: .sypha/rules-{mode-slug}/
• Global-Level: ~/.sypha/rules-{mode-slug}/