9b724f8cec
- Persist rotated Codex OAuth tokens after every successful refresh. - Reload stored credentials under cross-process locks before refreshing. - Write environment updates atomically with secret-only file permissions. - Preserve existing environment values while skipping empty replacements. - Activate configured vendors lazily and surface configuration failures immediately. - Reuse valid refresh tokens before starting interactive authentication. - Localize Codex setup, provider, request, and persistence errors. - Upgrade AI, cloud, telemetry, and supporting Go dependencies. - Set Claude Opus 5 as default changelog summarizer. - Document `.env` token sensitivity and rewrite behavior. |
||
|---|---|---|
| .. | ||
| images | ||
| voices | ||
| Automated-Changelog-Usage.md | ||
| Automated-ChangeLog.md | ||
| Azure-AI-Gateway.md | ||
| Azure-OpenAI-Troubleshooting.md | ||
| CODE_OF_CONDUCT.md | ||
| contexts-and-sessions-tutorial.md | ||
| CONTRIBUTING.md | ||
| Desktop-Notifications.md | ||
| DigitalOcean-Agents-Setup.md | ||
| docs.go | ||
| Gemini-TTS.md | ||
| GitHub-Models-Setup.md | ||
| Go-Updates-September-2025.md | ||
| i18n-variants.md | ||
| i18n.md | ||
| Microsoft-365-Copilot-Setup.md | ||
| NOTES.md | ||
| notification-config.yaml | ||
| Project-Restructured.md | ||
| README.md | ||
| rest-api.md | ||
| SECURITY.md | ||
| Shell-Completions.md | ||
| SUPPORT.md | ||
| swagger.json | ||
| swagger.yaml | ||
| Using-Speech-To-Text.md | ||
| YouTube-Processing.md | ||
Fabric Documentation
Welcome to the Fabric documentation! This directory contains detailed guides and technical documentation for various features and components of Fabric.
📚 Available Documentation
Core Features
Automated-Changelog-Usage.md Complete guide for developers on using the automated changelog system. Covers the workflow for generating PR changelog entries during development, including setup, validation, and CI/CD integration.
YouTube-Processing.md Comprehensive guide for processing YouTube videos and playlists with Fabric. Covers transcript extraction, comment processing, metadata retrieval, and advanced yt-dlp configurations.
Using-Speech-To-Text.md Documentation for Fabric's speech-to-text capabilities using OpenAI's Whisper models. Learn how to transcribe audio and video files and process them through Fabric patterns.
User Interface & Experience
Desktop-Notifications.md Guide to setting up desktop notifications for Fabric commands. Useful for long-running tasks and multitasking scenarios with cross-platform notification support.
Shell-Completions.md Instructions for setting up intelligent tab completion for Fabric in Zsh, Bash, and Fish shells. Includes automated installation and manual setup options.
Gemini-TTS.md Complete guide for using Google Gemini's text-to-speech features with Fabric. Covers voice selection, audio generation, and integration with Fabric patterns.
Development & Architecture
Automated-ChangeLog.md Technical documentation outlining the automated CHANGELOG system architecture for CI/CD integration. Details the infrastructure and workflow for maintainers.
Project-Restructured.md Project restructuring plan and architectural decisions. Documents the transition to standard Go conventions and project organization improvements.
NOTES.md Development notes on refactoring efforts, model management improvements, and architectural changes. Includes technical details on vendor and model abstraction.
Audio Resources
voices/README.md Index of Gemini TTS voice samples demonstrating different AI voice characteristics available in Fabric.
🗂️ Additional Resources
Configuration Files
./notification-config.yaml- Example notification configuration
Images
images/- Screenshots and visual documentation assetsfabric-logo-gif.gif- Animated Fabric logofabric-summarize.png- Screenshot of summarization featuresvelte-preview.png- Web interface preview
🚀 Quick Start
New to Fabric? Start with these essential docs:
- ../README.md - Main project README with installation and basic usage
- Shell-Completions.md - Set up tab completion for better CLI experience
- YouTube-Processing.md - Learn one of Fabric's most popular features
- Desktop-Notifications.md - Get notified when long tasks complete
🔧 For Contributors
Contributing to Fabric? These docs are essential:
- ./CONTRIBUTING.md - Contribution guidelines and setup
- Automated-Changelog-Usage.md - Required workflow for PR submissions
- Project-Restructured.md - Understanding project architecture
- NOTES.md - Current development priorities and patterns
📝 Documentation Standards
When adding new documentation:
- Use clear, descriptive filenames
- Include practical examples and use cases
- Update this README index with your new docs
- Follow the established markdown formatting conventions
- Test all code examples before publication
For general help and support, see ./SUPPORT.md