danielmiessler.fabric/docs
Kayvan Sylvan f37c71f9f7 fix: secure storage paths and authenticate REST and Ollama servers
- Reject unsafe cross-platform storage names and traversal attempts.
- Confine symlink targets within configured filesystem storage directories.
- Require API keys for every non-loopback server binding.
- Authenticate Ollama routes and securely forward configured credentials.
- Validate chat pattern, context, and session names early.
- Sanitize client errors to hide internal filesystem details.
- Default REST server binding to loopback port 8080.
- Add regression coverage for traversal, symlinks, and authentication.
2026-09-02 15:59:59 -07:00
..
images fix: optimize oversized logo images reducing package size by 93% 2025-12-25 11:38:34 +08:00
voices feat: add Gemini TTS voice selection and listing functionality 2025-07-26 15:11:30 -07:00
Automated-Changelog-Usage.md docs: Remove duplicated section. 2025-07-21 11:07:27 -07:00
Automated-ChangeLog.md feat: enhance changelog generator to accept version parameter for PR processing 2025-07-21 07:36:30 -07:00
Azure-AI-Gateway.md fix: Address copilot review comments 2026-02-23 14:29:25 -08:00
Azure-OpenAI-Troubleshooting.md docs: Add Azure OpenAI troubleshooting guide 2026-01-24 13:34:28 +11:00
CODE_OF_CONDUCT.md docs: add contributing, security, support, and code-of-conduct docs; add docs index 2025-08-26 07:10:08 -07:00
contexts-and-sessions-tutorial.md feat: add i18n support with Spanish localization and documentation improvements 2025-09-08 09:17:23 -07:00
CONTRIBUTING.md # CHANGES 2025-12-18 07:12:08 -08:00
Desktop-Notifications.md feat(cli): add cross-platform desktop notifications with secure custom commands 2025-08-08 00:20:51 -07:00
DigitalOcean-Agents-Setup.md feat: add DigitalOcean Gradient AI Agents as a new vendor 2026-01-13 22:52:13 -08:00
docs.go fix: secure storage paths and authenticate REST and Ollama servers 2026-09-02 15:59:59 -07:00
Gemini-TTS.md docs: update Gemini TTS model references to gemini-2.5-flash-preview-tts 2025-07-26 16:23:56 -07:00
GitHub-Models-Setup.md feat: add GitHub Models provider and refactor model fetching with direct API fallback 2025-11-23 15:02:33 +07:00
Go-Updates-September-2025.md chore: Go 1.25 upgrade and critical package updates for AI/ML services 2025-09-14 10:22:25 -07:00
i18n-variants.md feat(i18n): add i18n support for language variants (pt-BR/pt-PT) 2025-09-21 16:04:59 -07:00
i18n.md feat: add i18n support with Spanish localization and documentation improvements 2025-09-08 09:17:23 -07:00
Microsoft-365-Copilot-Setup.md chore: Note in the guide about restricted env + modernize fixes 2026-01-15 15:16:40 -08:00
NOTES.md refactor: restructure project to align with standard Go layout 2025-07-08 22:47:17 -07:00
notification-config.yaml chore: update model references to latest versions across docs and code 2026-02-12 16:45:05 -08:00
Project-Restructured.md fix: minor edit 2025-07-09 00:24:35 -07:00
README.md docs: add contributing, security, support, and code-of-conduct docs; add docs index 2025-08-26 07:10:08 -07:00
rest-api.md chore: update model references to latest versions across docs and code 2026-02-12 16:45:05 -08:00
SECURITY.md fix: persist refreshed Codex tokens and reactivate configured vendors 2026-08-27 18:12:08 -07:00
Shell-Completions.md fix: declare completion arguments and synchronize CLI help 2026-07-29 14:56:27 -07:00
SUPPORT.md docs: add contributing, security, support, and code-of-conduct docs; add docs index 2025-08-26 07:10:08 -07:00
swagger.json fix: secure storage paths and authenticate REST and Ollama servers 2026-09-02 15:59:59 -07:00
swagger.yaml fix: secure storage paths and authenticate REST and Ollama servers 2026-09-02 15:59:59 -07:00
Using-Speech-To-Text.md feat: add --debug flag with levels and centralized logging 2025-08-19 04:23:40 -07:00
YouTube-Processing.md feat: add -V/--vendor flag and vendor-aware model selection 2025-08-12 06:39:02 -07:00

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 assets
    • fabric-logo-gif.gif - Animated Fabric logo
    • fabric-summarize.png - Screenshot of summarization feature
    • svelte-preview.png - Web interface preview

🚀 Quick Start

New to Fabric? Start with these essential docs:

  1. ../README.md - Main project README with installation and basic usage
  2. Shell-Completions.md - Set up tab completion for better CLI experience
  3. YouTube-Processing.md - Learn one of Fabric's most popular features
  4. Desktop-Notifications.md - Get notified when long tasks complete

🔧 For Contributors

Contributing to Fabric? These docs are essential:

  1. ./CONTRIBUTING.md - Contribution guidelines and setup
  2. Automated-Changelog-Usage.md - Required workflow for PR submissions
  3. Project-Restructured.md - Understanding project architecture
  4. 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