System Manual
Getting Started
The Yiven IDE is a deterministic, AI-native development environment tailored for sovereign architects. Unlike traditional code editors, Yiven acts as a collaborative Vanguard node, actively analyzing and synthesizing code within the context of your specific system architecture.
- To launch the app, utilize the locally authenticated desktop client.
- Ensure your Sovereign Node is tied to an active license.
- Your local files are securely sandboxed via Tauri's virtual file system (VFS).
Mounting Workspaces
Before the Vanguard Engine can assist you, you must mount a local directory to serve as the structural context for your session.
- Click "Mount Workspace": Located at the top of the left-hand directory tree.
- Select Target Directory: Choose the root folder of your project via the native system dialog.
- Initialization: Yiven will recursively map your directory tree, recognizing project files, components, and ignoring standard exclusion directories (e.g., node_modules, .git).
Once mounted, you can right-click any file within the tree to rename, delete, open, or copy its path. [0.1.3 Protocol]: Sidebars for Search and Source Control are bound to the active workspace and will remain locked until a valid structural substrate is detected.
Vibe Coding Engine
The core interaction loop of Yiven is the Vibe Coding input panel located at the bottom of the right sidebar. You describe architectural changes, and the AI synthesizes exact code adjustments.
Single-File Edits
If the engine determines your prompt relates to the currently active file, it will stream exact code replacements directly into your editor.
Sequential Logic Synthesis
As of v0.1.3, the engine enforces a human-in-the-loop gate. All shell trajectories and file edits are throttled until the logic synthesis is complete, requiring explicit user authorization to execute.
Settings & Configurations
The Sovereign Vault (also known as the Settings Matrix) is the core configuration hub for your Vanguard node, allowing deep tuning of intelligence and system constraints.
AI Mesh & Providers
- Cryptographic Binding: Securely bind API keys for Claude, Gemini, OpenAI, Groq, and Perplexity. Only configured nodes will be leveraged when the agent plans architectures.
- Local Node (Ollama): Enable local processing to prioritize local Vanguard SLMs (e.g.,
Vanguard-3-7:latestorVanguard-6-11:latest). These default intelligently based on your active Logic Tier. - Consensus Mesh Protocol: Enable this to force Yiven I/O into Consensus Mode, cross-verifying generated logic across all active nodes simultaneously. (Warning: higher resource consumption).
MFA Hub & Access
- Manage Secrets: Safely add, edit, or purge secrets. When closed, contexts will automatically retain the last active state.
- Automation Toggles: Fine-tune independent file access rules, terminal override capabilities, and browser context access. Control whether the agent operates via Chat, Plan, or Auto modes.
System Utilities
- Auditory Interfaces: Toggle OS and error operational sounds for audio acknowledgment of generation completion strings.
- File Tree Operations: Configure whether hidden dotfiles (e.g.,
.env,.git) are exposed in the VFS by default. - Danger Zone: The deepest layer of the System tab. Perform a hard format of the Vanguard Node, purging all injected keys, offline leases, and resetting the logic baseline entirely.
Hardened MCP Tools
Model Context Protocol (MCP) utilities empower your Vanguard AI to observe the broader system state. To configure, open the Sovereign Hardened Substrate (MCP) vault from the top navigation bar or the footer link.
You can securely wire in integrations like brave-search for external web queries, local python execution logic, or custom internal command pipelines. All these tools run locally on your system to ensure zero external database logging.
Available Integrations
Puppeteer Deep Search
Equips the Heuristics Matrix with real-time web scraping and Google search parsing. Bypasses standard bot-protections to deliver high-fidelity HTML text extraction straight to context.
Awaiting Kernel Validation
VFS File System Crawler
In DevelopmentPermits the matrix to securely scan, read, and index local directories, CSVs, and massive PDF files on your native machine.
Postgres Architect
In DevelopmentGrants read-only SQL execution powers. The matrix can dynamically build queries, fetch database schemas, and output financial or telemetry graphs.
GitHub Automaton
In ArchitectureDirect API pipeline to your GitHub account. Pull down open issues, diff PRs, and commit fixes from the Sovereign console.
Terminal Executor
In ArchitectureHighly restricted bash/zsh execution. Allows the agent to trigger local build scripts, install npm dependencies, and view live log streams.
Please note: System integration is currently an experimental option. LLM mistakes are possible, but the system follows strict ethical and sovereign guidelines. Use with operational awareness.