Skip to main content
Terraphim AI documentation
  • Cloudflare Pages Deployment for Terraphim AI Documentation
  • Terraphim AI Performance Benchmarking Framework
  • Release Process Documentation
  • Architecture
  • ADR-0002: Polyrepo GitHub Publish Pipeline
  • Phase 1 §1 — Tooling Inventory
  • Aggregator decoupling sketch (Stage B, Gitea #1910)
  • Phase 1 §10 — Experimental Crate Register
  • Phase 1 §4 — Hub Fan-In Summary
  • Cold-build timing baseline -- Stage A (Gitea #1910)
  • Polyrepo topology (Gitea #1910)
  • Architecture: terraphim_agent
  • Terraphim Agent Auto-Update System
  • FFF Search Integration -- Capability Statement
  • Terraphim AI Component Architecture
  • Conare AI vs Terraphim: Context Engineering Comparison
  • Context Collections Management
  • Context Engineering with Terraphim: Quick Start
  • Context Library
  • Contributing to Terraphim-AI
  • Terraphim AI Deployment Guide
  • Terraphim AI Domain and Data Models
  • terraphim_automata - Text Matching and Autocomplete Engine
  • terraphim_config - Configuration Management
  • terraphim_middleware - Haystack Indexing and Orchestration
  • terraphim_persistence - Multi-Backend Storage Abstraction
  • terraphim_rolegraph - Knowledge Graph Implementation
  • terraphim_service - Main Service Layer
  • terraphim_types - Core Type Definitions
  • Terraphim AI Examples & Integration Guide
  • Example: terraphim_agent shared learning end-to-end
  • Terraphim GitHub Runner - Architecture Documentation
  • Terraphim GitHub Runner - Setup Guide
  • Terraphim AI Installation and Deployment Guide
  • LLM Proxy Configuration Guide
  • MCP File Context Tools
  • Perplexity Integration for Terraphim AI
  • Platform-Specific Installation Guide
  • Quickwit Integration Guide
  • Sentrux Quality Gates
  • ADF Behaviour Specifications
  • Specification: Local Project Skill Path Resolution
  • Specification: Provider Probe Timeout and Health Classification
  • Specification: Redacted Output Capture and Timeout Reporting
  • Specification: Webhook Group Alias Dispatch and Expansion Limits
  • Specification: Worktree Fail-Closed Behaviour
  • Chat & Session History - Quick Reference
  • Chat and Session History Specification
  • Specification Interview Findings: Enhanced Learning Capture System
  • Terraphim Agent Session Search - Architecture Document
  • Terraphim Agent Session Search - Feature Specification
  • Terraphim Agent Session Search - Implementation Tasks
  • Terraphim-Based Codebase Evaluation Check
  • Terraphim Desktop Application - Technical Specification
  • Terraphim AI Architecture
  • Code of Conduct
  • Contributing to Terraphim AI
  • Using Terraphim Desktop with Claude via MCP
  • Design Decisions
  • Introduction
  • Terraphim documentation
  • Summary
  • Use cases for Terraphim AI
  • Terraphim AI Agent Evolution System Architecture
  • 5 AI Agent Workflows for Consistent Results (with Code) | Data Science Collective
  • Terraphim AI Agent Evolution System - API Reference
  • Artifacts
  • Artifact: GitHub Actions Fix Plan for v1.0.0 Release
  • Artifact: v1.0.0 Final Validation Status
  • Artifact: Release Status Final
  • Atomic Server Integration
  • Automata Paragraph Extraction
  • Dynamic Ontology Launch Announcement
  • Introducing Dynamic Ontology: Schema-First Knowledge Graphs
  • FFF Search Integration: Knowledge-Graph-Augmented File Search for AI Agents
  • Your AI Agent Has Amnesia. We Fixed That.
  • Reddit Announcements
  • Reddit Announcements -- Terraphim Grep
  • Hybrid Code Search That Knows When to Ask an LLM
  • Grep That Knows When to Ask an LLM
  • X/Twitter Thread
  • X/Twitter Thread -- Terraphim Grep
  • Branch Protection and Security
  • Case Studies
  • Case Study: Symphony Builds a Web Application
  • Changelog
  • Claude Code Skills Integration
  • Code Assistant Implementation (PR #277)
  • How-To: Learning-Driven Command Rewriting
  • Terraphim Atomic Client
  • Terraphim Automata
  • Terraphim Service
  • Crate Reference
  • Desktop App
  • Development Setup Guide
  • CI/CD Domain
  • Deployment Lessons: Vanilla JS UI + Caddy + 1Password
  • GitHub Actions Fix Plan (v1.0.0)
  • Desktop Domain
  • Release Domain
  • Final Validation Status (v1.0.0)
  • Security Domain
  • Security Testing Lessons Learned
  • VM Domain
  • Dynamic Ontology
  • Automata Evaluation Framework
  • Graph Connectivity Check for Matched Terms
  • 1Password Integration for Terraphim AI\n\n## Overview\n\nThis document describes the comprehensive 1Password integration for Terraphim AI, providing enterprise-grade secret management across all components including backend services, desktop applications, and CI/CD pipelines.\n\n## Architecture\n\n### Three-Vault Strategy\n\n- Terraphim-Dev: Development environment secrets\n- Terraphim-Prod: Production environment secrets \n- Terraphim-Shared: Shared secrets across environments (signing keys, monitoring)\n\n### Integration Methods\n\n#### Method 1: Process Memory Injection (Recommended)\nbash\n# Secrets are injected directly into process memory\nop run --env-file=\".env.terraphim\" -- cargo run\n\n\n#### Method 2: Secure File Injection\nbash\n# Secrets are written to secure temporary files\nop inject -i templates/settings.toml.template -o settings.toml\ncargo run\n\n\n## Setup Instructions\n\n### 1. Install 1Password CLI\n\nmacOS:\nbash\nbrew install 1password-cli\n\n\nLinux:\nbash\ncurl -sS https://downloads.1password.com/linux/keys/1password.asc | gpg --import\nwget https://downloads.1password.com/linux/debian/amd64/stable/1password-cli-amd64-latest.deb\nsudo dpkg -i 1password-cli-amd64-latest.deb\n\n\n### 2. Initialize 1Password Integration\n\nbash\n# Run the setup script to create vaults and secret structure\n./scripts/setup-1password-terraphim.sh dev\n\n# For production setup\n./scripts/setup-1password-terraphim.sh prod\n\n# For complete setup\n./scripts/setup-1password-terraphim.sh all\n\n\n### 3. Populate Secrets\n\nAfter running the setup script, you'll need to update the placeholder values in 1Password with actual secrets:\n\n1. Open 1Password and navigate to the appropriate vault\n2. Update each secret item with real values\n3. Ensure all op:// references in templates are valid\n\n## Usage\n\n### Backend Services\n\n#### Option 1: Direct 1Password Integration\nrust\nuse terraphim_settings::DeviceSettings;\n\n#[tokio::main]\nasync fn main() -> Result<(), Box<dyn std::error::Error>> {\n // Load settings with 1Password integration\n let settings = DeviceSettings::load_with_onepassword(None).await?;\n println!(\"Loaded settings with resolved secrets\");\n Ok(())\n}\n\n\n#### Option 2: Template-based Configuration\nbash\n# Generate configuration from template\nop inject -i templates/settings.toml.template -o settings.toml\n\n# Run application with resolved configuration\ncargo run\n\n\n### Desktop Application\n\nThe Tauri desktop application includes built-in 1Password commands:\n\ntypescript\nimport { invoke } from '@tauri-apps/api/tauri';\n\n// Check 1Password status\nconst status = await invoke('onepassword_status');\nconsole.log('1Password available:', status.available);\nconsole.log('1Password authenticated:', status.authenticated);\n\n// Resolve a secret reference\nconst secret = await invoke('onepassword_resolve_secret', {\n request: { reference: 'op://Terraphim-Dev/OpenRouter/API_KEY' }\n});\n\n// Process configuration with 1Password\nconst config = await invoke('onepassword_process_config', {\n request: { config: 'api_key = \"op://Terraphim-Dev/OpenRouter/API_KEY\"' }\n});\n\n\n### CI/CD Integration\n\nUse the enhanced GitHub Actions workflow with 1Password service accounts:\n\nyaml\n# .github/workflows/ci-1password.yml\nname: CI with 1Password\n\nenv:\n OP_SERVICE_ACCOUNT_TOKEN: ${{ secrets.OP_SERVICE_ACCOUNT_TOKEN }}\n\njobs:\n build:\n steps:\n - name: Install 1Password CLI\n uses: 1password/install-cli-action@v1\n \n - name: Generate configuration\n run: |\n op inject -i templates/env.terraphim.template -o .env.terraphim\n \n - name: Build with secrets\n run: |\n source .env.terraphim\n cargo build --release\n\n\n## Configuration Templates\n\n### Environment Variables Template\nbash\n# templates/env.terraphim.template\nOPENROUTER_API_KEY=\"op://Terraphim-Dev/OpenRouter/API_KEY\"\nANTHROPIC_API_KEY=\"op://Terraphim-Dev/Anthropic/API_KEY\"\nATOMIC_SERVER_SECRET=\"op://Terraphim-Dev/AtomicServer/SECRET\"\n\n\n### Settings Configuration Template\ntoml\n# templates/settings.toml.template\n[profiles.s3]\nbucket = \"op://Terraphim-Dev/AWS_S3/BUCKET_NAME\"\naccess_key_id = \"op://Terraphim-Dev/AWS_S3/ACCESS_KEY_ID\"\nsecret_access_key = \"op://Terraphim-Dev/AWS_S3/SECRET_ACCESS_KEY\"\n\n\n### Application Configuration Template\njson\n{\n \"llm\": {\n \"openrouter\": {\n \"api_key\": \"op://Terraphim-Dev/OpenRouter/API_KEY\"\n }\n }\n}\n\n\n## Secret Categories\n\n### LLM API Keys\n- OpenRouter: API_KEY, ORGANIZATION_ID\n- Anthropic: API_KEY, MODEL_NAME\n- Ollama: BASE_URL, MODEL_NAME\n\n### Search Services\n- Perplexity: API_KEY\n- Atomic Server: URL, SECRET\n- ClickUp: API_TOKEN, TEAM_ID, LIST_ID\n\n### Cloud Storage\n- AWS S3: ACCESS_KEY_ID, SECRET_ACCESS_KEY, BUCKET_NAME, REGION\n- Cloudflare R2: ACCOUNT_ID, ACCESS_KEY_ID, SECRET_ACCESS_KEY\n\n### External APIs\n- GitHub: TOKEN, ORGANIZATION, REPOSITORY\n- Discord: BOT_TOKEN, GUILD_ID, CHANNEL_ID\n\n### Database Connections\n- PostgreSQL: CONNECTION_STRING, USERNAME, PASSWORD\n- Redis: URL, PASSWORD, HOST, PORT\n\n### Shared Secrets\n- Tauri Signing: PRIVATE_KEY, PUBLIC_KEY, PASSPHRASE\n- Code Signing: CERTIFICATE_PATH, CERTIFICATE_PASSWORD\n- Monitoring: SENTRY_DSN, DATADOG_API_KEY\n\n## Security Best Practices\n\n### 1. Vault Access Control\n- Use separate vaults for different environments\n- Implement least-privilege access policies\n- Regularly audit vault permissions\n\n### 2. Secret Rotation\n- Rotate API keys regularly\n- Update 1Password references when secrets change\n- Monitor for deprecated or expired secrets\n\n### 3. Template Security\n- Never include hardcoded secrets in templates\n- Use only op:// references in configuration templates\n- Validate template format before deployment\n\n### 4. CI/CD Security\n- Use 1Password service accounts for automation\n- Limit service account permissions to specific vaults\n- Clean up generated configuration files after use\n\n## Troubleshooting\n\n### Common Issues\n\n#### 1Password CLI Not Authenticated\nbash\n# Sign in to 1Password\nop signin\n\n# Verify authentication\nop vault list\n\n\n#### Secret Reference Not Found\nbash\n# Check vault contents\nop item list --vault=\"Terraphim-Dev\"\n\n# Verify specific item\nop item get \"OpenRouter\" --vault=\"Terraphim-Dev\"\n\n\n#### Template Processing Failed\nbash\n# Validate template syntax\nop inject -i templates/env.terraphim.template --dry-run\n\n# Check for malformed references\ngrep -n \"op://\" templates/env.terraphim.template\n\n\n### Debug Commands\n\nbash\n# Test 1Password integration\ncargo run --bin debug-onepassword\n\n# Validate configuration templates\n./scripts/validate-templates.sh\n\n# Check secret resolution\nop run --env-file=\".env.terraphim\" -- env | grep -E '^(OPENROUTER|ANTHROPIC)'\n\n\n## Development Workflow\n\n### Local Development\n1. Install 1Password CLI and authenticate\n2. Run vault setup script: ./scripts/setup-1password-terraphim.sh dev\n3. Populate development secrets in 1Password\n4. Generate configuration: op inject -i templates/env.terraphim.template -o .env.terraphim\n5. Run application: source .env.terraphim && cargo run\n\n### Testing\n1. Use separate test vault or test-specific items\n2. Generate test configuration with mock values\n3. Run tests with isolated secrets: op run --env-file=\".env.test\" -- cargo test\n\n### Production Deployment\n1. Use production vault and service accounts\n2. Validate all secret references before deployment\n3. Deploy using CI/CD pipeline with 1Password integration\n4. Monitor for secret-related errors and alerts\n\n## Migration Guide\n\n### From Environment Variables\n1. Identify current environment variables\n2. Create corresponding 1Password items\n3. Update configuration templates with op:// references\n4. Test secret resolution in development\n5. Deploy with 1Password integration\n\n### From Configuration Files\n1. Extract sensitive values from configuration files\n2. Store values in 1Password vaults\n3. Replace sensitive values with op:// references\n4. Use op inject to generate final configuration\n5. Update deployment scripts to use template injection\n\n## Support\n\nFor issues with 1Password integration:\n1. Check this documentation for common solutions\n2. Validate 1Password CLI installation and authentication\n3. Review secret references and vault permissions\n4. Test with minimal configuration first\n5. Contact the Terraphim team for additional support\n\n---\n\nNext Steps:\n- Set up your 1Password vaults using the setup script\n- Populate secrets with real values\n- Test integration in development environment\n- Deploy with 1Password-enhanced CI/CD pipeline
  • Haystack Configuration with Extra Parameters
  • Lessons Learned
  • Progress Memories
  • Terraphim AI Project Memory
  • Current Work: Terraphim Multi-Role Agent System Testing & Production 🚀
  • Comprehensive Lessons Learned - Terraphim AI Development
  • Security Testing Patterns - Terraphim AI
  • Security Testing Lessons Learned (2025-10-07)
  • Terraphim Firecracker Project - Implementation Plan
  • Terraphim AI Security Testing Implementation - Complete
  • Terraphim AI Testing Infrastructure Improvement Plan
  • Installing Terraphim AI
  • AI Agent Onboarding Quickstart
  • Graph Embeddings for Checklists
  • Howto: Learning Capture for Claude Code
  • Howto: Learning Capture for opencode
  • Plug Terraphim Search into Claude Code and opencode
  • Personal Assistant Role: Search Email and Notes Together
  • 3 Ways to Save Money on Tokens for Your AI Agents
  • Zero-Token LLM Routing: Deterministic Decisions Before the Call
  • Package Manager Replacement with Bun
  • Example Knowledge Graph
  • API
  • Bug Reporting
  • bun install
  • bun
  • Case Study: Knowledge Graph Validation Workflows for Pre/Post-LLM
  • code_review_checklist
  • security_checklist
  • Configuration
  • Database
  • docker compose
  • Exit Classes
  • Generated with Terraphim AI
  • Terraphim Graph Embeddings: Learning Agent Guide
  • Graph
  • Haystack
  • https://terraphim.ai
  • Issue Tracking
  • Terraphim Knowledge Graph System
  • Knowledge Graph
  • Learning Capture System
  • Middleware
  • [email protected]
  • Terraphim KG Schema Linter
  • Search
  • Service
  • System
  • Terraphim-graph
  • Terraphim AI
  • Thesaurus
  • uv
  • uv add
  • Knowledge Graph Bug Reporting Enhancement
  • Learning Compile
  • Listener Shell Dispatch
  • MCP Integration
  • OpenRouter AI-Powered Article Summarization
  • Release Channels
  • Release Process for Terraphim AI
  • Design: PageRank Bug Fixes for Gitea Robot API
  • Research: PageRank Computation Bug in Gitea Robot API
  • Research Document: TypeScript Bindings for TLA+
  • Design Document: TypeScript Bindings for TLA+
  • Title-Scorer
  • BM25 Scorers
  • Terraphim Graph Embeddings vs Cleora
  • Terraphim Graph scorer
  • Terraphim vs OpenClaw: Search Architecture Comparison
  • Terraphim Search Architecture
  • Symphony Orchestrator
  • Test KG Auto-linking Demo
  • Relationship between Aircraft and Crew
  • Comprehensive Testing Strategies for Terraphim
  • Desktop Testing
  • Chat Layout Responsive Design Test Plan
  • Desktop Frontend Testing Guide
  • Knowledge Graph Ranking Expansion Testing
  • MCP Integration Testing
  • Testing Overview
  • Terraphim AI Agent Evolution System - Testing Matrix
  • TypeScript Bindings with tsify
  • Terraphim TUI
  • Terraphim AI Agent Workflow Patterns Guide
  • Decision Tier
  • Implementation Tier
  • Planning Tier
  • Review Tier
  • Runner Command Policy
  • Terraphim TUI Features
  • Terraphim Terminal User Interface (TUI)
  • Terraphim AI Update Signing Keys
  • Getting Started with Terraphim AI
  • Installation Guide
  • Quick Start Guide
  • Quickwit Log Exploration Guide
  • Setting Up Telegram Bot with TinyClaw
  • Enabling terraphim-grep Offline (lessons learned)
  • Troubleshooting Guide
  • Released VS Code extension with a real Terraphim server
  • Creating a Front-End Developer Agent with Terraphim

[email protected]

Terraphim AI no-reply email address.

synonyms:: [email protected]

Middleware Terraphim KG Schema Linter

© 2026 Terraphim AI documentation. Built with md-book.

GitHub