# memory_nodes

id: f080d9f1-7a52-443e-b81c-9bd0c76bd111
summary: Document: 01-registration-and-onboarding.md
category: knowledge
created_at: 2026-03-12 13:12:26
source_type: document_summary
source_ref: general:/CQ-User-Manual:01-registration-and-onboarding.md
source_range: 1:60
content:
Document: 01-registration-and-onboarding.md

The document "01-registration-and-onboarding.md" outlines the initial steps for setting up a user account and configuring the CitadelQuest environment. The registration process requires a unique username, a password, and an email address for recovery, which is stored locally to ensure privacy. Notably, the first person to register on a new installation is granted Admin privileges, though administrators have the ability to disable further registrations. Users are encouraged to keep the "Auto-create CQ AI Gateway account" option checked to facilitate a seamless setup.

Following registration, a three-step onboarding wizard guides the user through essential configurations. Step one involves connecting to the CQ AI Gateway, which provides access to various AI models like Claude and Gemini; users who opted for automatic creation receive free starting credits. Step two focuses on creating a "Spirit," a personal AI companion, by selecting a name and a visual identification color. The final step offers the choice to either begin an immediate conversation with the new Spirit or explore the central Dashboard. Additionally, the document notes that CitadelQuest supports English, Czech, and Slovak languages, which can be toggled via the navigation bar and are saved to the user's profile for future sessions.


id: fd441b64-9557-464b-b15c-080626d39052
summary: Section: Creating Your Account
category: knowledge
created_at: 2026-03-12 13:12:45
source_type: document
source_ref: general:/CQ-User-Manual:01-registration-and-onboarding.md
source_range: 1:19
content:
Document: Creating Your Account

The document "Creating Your Account" provides a step-by-step guide for registering and onboarding onto a CitadelQuest instance. To create an account, users must navigate to the platform via a web browser and select the "Register" option. The registration process requires a unique username, a password, and an email address intended for account recovery. Notably, this email is stored only within the user's local database to ensure privacy.

The guide highlights a "zero-friction" setup option by recommending that users keep the "Auto-create also CQ AI Gateway account" box checked, which automates the initial AI configuration. Administrative privileges are automatically granted to the very first person who registers on a new installation. Additionally, the document notes that registration is a permission-based feature; if the Citadel administrator has disabled the function, prospective users must contact them directly to gain access. The overall process is designed to prioritize user autonomy and ease of use while maintaining the platform's decentralized security model.


id: 624ac4e8-9af6-42b8-93fe-e514b7e7c1fc
summary: Section: Onboarding Wizard: AI and Spirit Setup
category: knowledge
created_at: 2026-03-12 13:13:13
source_type: document
source_ref: general:/CQ-User-Manual:01-registration-and-onboarding.md
source_range: 20:39
content:
Document: Onboarding Wizard: AI and Spirit Setup

The Onboarding Wizard is a three-step process designed to guide new users through the initial setup of their CitadelQuest experience following their first login. The primary focus of this guide is the integration of AI services and the creation of a personal AI companion, known as a Spirit.

In the first step, users connect to the CQ AI Gateway, which provides access to advanced AI models such as Claude, Gemini, and Grok. This setup can be handled automatically if the user opted to create a CQ AI Gateway account during registration, which includes free starting credits. Alternatively, users can manually enter an existing API key or skip the step to configure it later in the settings.

The second step involves creating a Spirit. Users customize their AI companion by assigning it a name and a specific color for visual identification. While the system automatically selects a smart default AI model to allow for immediate interaction, users maintain the flexibility to change the model at any time through the Spirit Profile. This onboarding ensures that the core functionalities of the platform—AI augmentation and personalized assistance—are ready for use immediately upon entry.


id: 56d69ed3-d0f5-414c-b07d-a3ad52e09863
summary: Section: Post-Onboarding and Language Settings
category: knowledge
created_at: 2026-03-12 13:13:39
source_type: document
source_ref: general:/CQ-User-Manual:01-registration-and-onboarding.md
source_range: 40:60
content:
Document: Post-Onboarding and Language Settings

The document outlines the final steps of the onboarding process and the available language settings within the CitadelQuest platform. Upon completing onboarding, users are presented with two primary paths: they can select "Start" to initiate their first conversation with their Spirit and explore platform features, or select "Dashboard" to access their central hub for managing activities. Additionally, the guide details the platform's multilingual support, noting that users can switch between English (EN), Czech (CZ), and Slovak (SK) at any time via the language icon in the top navigation bar. These language preferences are saved and remain consistent across future sessions.


id: 85fb774c-e8e7-4611-91cd-44a19a072386
summary: Document: 03-spirits.md
category: knowledge
created_at: 2026-03-12 13:18:13
source_type: document_summary
source_ref: general:/CQ-User-Manual:03-spirits.md
source_range: 1:127
content:
Document: 03-spirits.md

Spirits are the central AI companions of the CitadelQuest platform, designed to learn, remember, and evolve alongside the user. This document details their management, functionality, and the gamified progression system that defines their growth.

Users manage their companions via the Spirits List (`/spirits`), where each Spirit is represented by a card showing its name, custom color, and current level. The Spirit Profile (`/spirit/{id}`) allows for deep customization, including selecting AI models from providers like Anthropic, Google, or xAI, and configuring system prompts through an Advanced Prompt Builder. This profile also features a 3D Memory Explorer preview, which visualizes the Spirit's knowledge graph and interaction history.

Interaction primarily occurs through the Spirit Chat, a modal overlay that supports Markdown, image and PDF attachments, and memory synthesis. A key feature of Spirits is their ability to use AI Tools automatically to manage files, search the web, generate images, and perform complex memory operations like extraction and recall.

The system incorporates a leveling mechanic where Spirits earn experience points (XP) through conversations, tool usage, and memory processing. As users engage with their Spirits, these companions level up, visually tracking the progress of the human-AI collaboration. New Spirits can be created easily by defining a name, model, and color, which initializes them with basic identity memory nodes.


id: 49196b83-0bc8-49c0-a5cb-2b991d57e65c
summary: Section: Introduction to Spirits
category: knowledge
created_at: 2026-03-12 13:18:26
source_type: document
source_ref: general:/CQ-User-Manual:03-spirits.md
source_range: 1:6
content:
Document: Introduction to Spirits

Spirits represent the core component of the CitadelQuest platform, serving as personalized AI companions designed for long-term interaction. These entities are characterized by their ability to learn from user engagement, maintain a persistent memory, and evolve over time. Each Spirit is distinct, featuring its own unique personality and specific set of capabilities, functioning as a growth-oriented partner that develops alongside the user within the ecosystem.


id: aef300c2-1723-48a7-9ab4-b83c9342ef57
summary: Section: Spirits List Management
category: knowledge
created_at: 2026-03-12 13:18:53
source_type: document
source_ref: general:/CQ-User-Manual:03-spirits.md
source_range: 7:20
content:
Document: Spirits List Management

The Spirits List Management document details the functionality of the Spirits page located at the /spirits route. This interface presents a user's AI companions as individual cards, which serve as the primary hub for managing and interacting with them. Each card provides essential visual and status information, including a custom-colored icon, the Spirit's name, and their current level and experience points (XP). Additionally, the cards offer quick access links to the Spirit's chat interface and detailed profile. Beyond viewing existing companions, the page allows users to initiate the creation of new Spirits or select an existing one to perform further management tasks. The system is designed to provide a clear overview of all active AI entities within the CitadelQuest environment.


id: c39275dc-8438-45f5-acca-639882d9ac61
summary: Section: Spirit Profile and Configuration
category: knowledge
created_at: 2026-03-12 13:19:04
source_type: document
source_ref: general:/CQ-User-Manual:03-spirits.md
source_range: 21:43
content:
Document: Spirit Profile and Configuration

The Spirit Profile and Configuration document details the features and settings available at the `/spirit/{id}` route within the CitadelQuest platform. This interface serves as the central hub for a user's Spirit, organized into three primary sections. The Identity & Level section features visual elements like a customizable icon with glow effects, the Spirit's name, and an experience bar that tracks progress and leveling based on user interactions. The AI Model section allows users to select the specific large language model powering their Spirit, offering choices from providers such as Anthropic, Google, and xAI. Finally, the System Prompt section provides tools for defining the Spirit's personality and expertise. This includes an Advanced Prompt Builder for fine-tuning behavior rules and selecting memory types, such as Legacy .md files or a Memory Agent. Changes made in this section must be saved to take effect, ensuring the Spirit behaves according to the user's specific requirements and custom instructions.


id: 10512eb2-de99-45b3-b749-a8db5f5e9379
summary: Section: Memory and Interaction History
category: knowledge
created_at: 2026-03-12 13:19:16
source_type: document
source_ref: general:/CQ-User-Manual:03-spirits.md
source_range: 44:60
content:
Document: Memory and Interaction History

The document outlines the Memory and Interaction History features within the CitadelQuest platform, specifically focusing on how users monitor and manage their Spirit's development. It details three primary sections: the Memory Explorer Preview, Recent Interactions, and Conversations.

The Memory Explorer Preview provides a 3D knowledge graph visualization that displays metrics such as pack, node, and relationship counts. It includes an "Explore" button for deeper data filtering and a "Memory Agent" badge to indicate the active processing mode. The Recent Interactions section serves as a chronological log, tracking timestamps, interaction types—such as creation, conversation, and tool usage—and the experience points (XP) earned by the Spirit. Finally, the Conversations section allows users to manage their dialogues, providing tools to view existing chat lists, open specific conversations, or initiate new ones. Together, these features offer a comprehensive overview of the Spirit's growth, knowledge structure, and engagement history.


id: 273a9c62-6d2f-4ae8-a817-d396fd5d0e28
summary: Section: Spirit Chat Interface
category: knowledge
created_at: 2026-03-12 13:19:44
source_type: document
source_ref: general:/CQ-User-Manual:03-spirits.md
source_range: 61:85
content:
Document: Spirit Chat Interface

The Spirit Chat Interface is a modal overlay within the CitadelQuest platform designed to provide seamless access to AI assistance without navigating away from current tasks. It can be accessed via the top navigation bar or through specific conversations in the Spirit Profile. The interface supports rich interactions, including message input, full Markdown formatting for AI responses, and the ability to attach images and PDF documents for analysis and memory extraction.

A key feature of the interface is its advanced memory synthesis display. When the AI recalls information, the chat provides an expandable panel showing memory nodes, a mini 3D graph visualization of connections, a synthesis quality indicator, and keyword tags. Users can monitor their resource usage through a context window indicator integrated into the input area's border.

Control features allow for significant customization and management of the interaction. Users can adjust the AI's creativity using a temperature slider and view specific model details via an info button. Additionally, the interface includes an "Extract Memory & Close" function, which allows users to save the conversation as a CQ Memory Pack and end the session in a single action.


id: f53218b5-f2aa-4adb-902c-e88a44f11e67
summary: Section: AI Tools and Capabilities
category: knowledge
created_at: 2026-03-12 13:20:12
source_type: document
source_ref: general:/CQ-User-Manual:03-spirits.md
source_range: 86:108
content:
Document: AI Tools and Capabilities

The document "AI Tools and Capabilities" outlines the various functional tools available to a user's Spirit within the CitadelQuest platform. These tools are designed to be used automatically by the AI during natural conversation to assist with a wide range of tasks. 

The capabilities are categorized into four primary areas: file management, memory systems, web access, and image generation. File-related tools allow the Spirit to browse the file system, read content, search for specific files, and perform management tasks such as creating, renaming, moving, or deleting data. The "updateFileEfficient" tool specifically enables precise editing of file segments. 

The memory suite provides advanced information retention, allowing the Spirit to store and recall important details. This includes "memoryExtract," which utilizes automatic relationship analysis to turn document knowledge into memory graphs, and "memorySource" to verify original data. Additionally, the Spirit can access external information via "fetchURL" and create or edit visual content using AI diffusion models through the "imageEditorSpirit" and "diffusionArtistSpirit" tools. Overall, the document emphasizes a seamless user experience where the Spirit autonomously selects the appropriate tool to fulfill user requests.


id: bcb05ed5-9d44-4628-be3d-684beac42b73
summary: Section: Spirit Creation and Progression
category: knowledge
created_at: 2026-03-12 13:20:40
source_type: document
source_ref: general:/CQ-User-Manual:03-spirits.md
source_range: 109:127
content:
Document: Spirit Creation and Progression

To create a new Spirit in CitadelQuest, users navigate to the spirits section and select the creation option. The setup process involves choosing a name, selecting an AI model, and assigning a color. Upon creation, the Spirit is automatically initialized with starter memory nodes that establish identity for both the user and the Spirit, allowing for immediate interaction.

Spirits evolve through a gamified progression system based on experience points (XP). They earn XP by engaging in conversations, utilizing AI tools to assist the user, and performing memory operations such as storing or processing information. As the Spirit accumulates XP, its experience bar fills and its level increases, fostering a more engaging and collaborative journey between the human and the AI.


id: a26434c2-2f0a-4a19-8851-8757e21ddbf1
summary: Document: 04-cq-memory.md
category: knowledge
created_at: 2026-03-12 13:22:10
source_type: document_summary
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 1:202
content:
Document: 04-cq-memory.md

CQ Memory is CitadelQuest's advanced knowledge management system that transforms unstructured data into interactive 3D knowledge graphs. This system allows Spirits to maintain persistent, contextual memory by organizing information into "Memory Packs" (.cqmpack)—portable SQLite databases containing nodes (facts, thoughts, or preferences) and typed relationships (relates to, reinforces, contradicts, or part of). These packs are organized into "Memory Libraries" (.cqmlib) where users can set priorities and categorize knowledge.

The Memory Explorer interface (/memory) features a 3D force-directed graph rendered with Three.js, allowing users to visually navigate their data. Knowledge is added through an Extraction Panel that supports files, URLs, manual text, and Spirit conversation transcripts. Once extracted, the system can perform relationship analysis to automatically discover connections across the graph.

Spirit integration is a core feature, offering two recall modes: "Reflexes" for fast context retrieval and "Memory Agent" for high-quality synthesis using sub-agent AI. In Spirit Chat, recalled memories are displayed with mini-graphs and relevance scores. Additionally, the system supports data sovereignty and collaboration through CQ Share, enabling users to share auto-syncing Memory Packs with contacts or the public. Key use cases include research, document analysis, and building specialized knowledge bases for personal AI assistants.


id: df4f6b2b-ec31-4523-a509-90382945cc1d
summary: Section: Introduction to CQ Memory
category: knowledge
created_at: 2026-03-12 13:22:24
source_type: document
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 1:6
content:
Document: Introduction to CQ Memory

CQ Memory is the specialized knowledge management system within the CitadelQuest platform designed to facilitate persistent and contextual memory for Spirits. The system functions by processing unstructured data, including documents, web pages, and conversation histories, and transforming that information into interactive 3D knowledge graphs. This architectural approach allows for a sophisticated organization of information that enhances the AI's ability to recall and utilize relevant context during user interactions. By converting static content into a dynamic visual and data-driven format, CQ Memory serves as the foundational layer for long-term information retention and retrieval within the CitadelQuest ecosystem.


id: 981c25eb-0e25-4ef9-974b-e1c6b2cf98da
summary: Section: Key Concepts and Data Structures
category: knowledge
created_at: 2026-03-12 13:22:51
source_type: document
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 7:43
content:
Document: Key Concepts and Data Structures

This document outlines the fundamental data structures and conceptual framework for managing knowledge within the CitadelQuest ecosystem. It introduces the Memory Pack (.cqmpack), a portable SQLite database that functions as a standalone knowledge graph containing nodes, typed relationships, tags, and source content. These packs are designed for easy sharing between users and Citadels. Multiple packs can be organized into a Memory Library (.cqmlib), which allows users to manage collections by enabling or disabling specific packs, setting search priorities, and categorizing them through tags.

The core unit of information is the Memory Node, which stores content, summaries, and metadata such as category (e.g., fact, preference, or thought) and importance levels that decay over time. These nodes are linked via Relationships that define the semantic connection between data points. Specific relationship types include RELATES_TO (blue), REINFORCES (green), CONTRADICTS (red), and PART_OF (white/grey), providing a visual and structural hierarchy for the knowledge graph. Together, these components create a sophisticated system for tracking, connecting, and preserving information with full source transparency.


id: e7e9d105-0e1a-4c44-9f17-dbf2d3144ab7
summary: Section: Memory Explorer Interface
category: knowledge
created_at: 2026-03-12 13:23:27
source_type: document
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 44:96
content:
Document: Memory Explorer Interface

The Memory Explorer is a specialized interface within the CitadelQuest platform, accessible via the `/memory` route, designed for the visualization and management of knowledge graphs. The interface features a three-part layout: a left sidebar for node lists and analysis tools, a top bar for library and pack selection, and a central interactive 3D graph visualization powered by Three.js.

The 3D visualization represents data through colored spheres (nodes) and connecting lines (edges), where colors indicate categories or relationship types and node size reflects importance. Users can interact with the graph through various mouse and keyboard commands, including zooming, rotating, panning, and deleting nodes. Clicking a node reveals specific details such as content, importance, tags, and source documentation.

Management of these knowledge graphs is organized through Libraries and Packs. The Library Selector allows users to filter views by specific libraries or view a Spirit's unique memory, while the Pack Selector provides details on node and relationship counts along with AI usage statistics. Users can create new packs and libraries directly within the interface to organize their data. This tool serves as a central hub for navigating complex information structures and managing the underlying `.cqmpack` files within a user's project.


id: e9b83b50-ce81-4148-9f3d-6c9786fe989e
summary: Section: Memory Extraction Process
category: knowledge
created_at: 2026-03-12 13:24:02
source_type: document
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 97:127
content:
Document: Memory Extraction Process

The Memory Extraction process in CitadelQuest allows users to transform information from various sources into structured knowledge packs. The system supports four primary source types: Files (PDFs, text, or code), URLs for web content, direct Text input for notes, and Conversation transcripts from specific Spirits. 

The extraction workflow begins by selecting a source and initiating the process. As the AI recursively processes the content, it splits information into logical blocks and builds a hierarchical structure, which is visualized through a real-time 3D graph update. Once the initial extraction is complete, the system can automatically perform a relationship analysis to discover and map connections between the newly created nodes. 

All resulting knowledge is stored within a designated pack. Because this process utilizes the CQ AI Gateway, it consumes AI credits. Users can monitor their resource consumption through the Pack Details modal, which provides comprehensive statistics on token usage and total credit costs. This feature essentially enables the creation of a sophisticated, interconnected knowledge graph that enhances the capabilities of the user's personal AI environment.


id: b7adbc37-239e-41fc-917c-62b612be0cf6
summary: Section: Memory Analysis and Jobs
category: knowledge
created_at: 2026-03-12 13:24:25
source_type: document
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 128:145
content:
Document: Memory Analysis and Jobs

The Memory Analysis and Jobs document outlines the functionality of the Memory Analyze Panel, which allows users to discover connections between nodes after knowledge extraction. It details two primary analysis methods: Whole Pack Analysis, which examines all nodes within a selected Memory Pack to map the entire knowledge graph, and Selected Root Node Analysis, which focuses on specific branches or topics for more targeted relationship discovery. The system utilizes a hierarchical strategy optimized for efficiency, employing intra-document leaf pairs and cross-document root-gating with recursive drill-down. Additionally, the document highlights the Active CQ Memory Jobs feature, noting that a status icon in the global app footer provides real-time visibility of extraction or analysis processes from any page within the application.


id: d53d081b-6f67-4155-8069-711b2449468c
summary: Section: Spirit Memory Integration
category: knowledge
created_at: 2026-03-12 13:24:43
source_type: document
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 146:177
content:
Document: Spirit Memory Integration

The "Spirit Memory Integration" document outlines how Spirits within the CitadelQuest platform store and recall information through a dedicated Memory Library. Memory is categorized into three types: Reflexes, which provide fast and automatic context recall; Memory Agent, an advanced mode where a sub-agent synthesizes and evaluates graph connections for higher-quality responses at a higher credit cost; and Legacy, which maintains backward compatibility with older .md text files.

The recall process follows a structured six-step workflow: a user message triggers a search across all enabled memory packs, relevant nodes are identified via keyword matching, and—if in Memory Agent mode—the data is synthesized by a sub-agent. This context is then delivered to the Spirit, allowing it to respond with awareness of past interactions and knowledge.

Users can monitor this process in the Spirit Chat through a specialized Memory Synthesis Display. This interface includes an expandable panel detailing the specific memories used, a mini 3D graph for visualizing node connections, and various indicators such as relevance score badges, identification tags, and "Graph" badges for nodes discovered through relationship expansion. This system ensures that Spirits maintain a persistent, evolving understanding of the user's data and history.


id: e6da62d1-5272-4316-8fa4-652f2a8ad291
summary: Section: Sharing and Syncing
category: knowledge
created_at: 2026-03-12 13:25:14
source_type: document
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 178:191
content:
Document: Sharing and Syncing

The document "Sharing and Syncing" outlines the process for distributing Memory Packs within the CitadelQuest ecosystem. Users can share these packs either publicly or with specific CQ Contacts through the Memory Explorer dropdown menu or the dedicated CQ Share management page. The system supports two primary visibility scopes: Public, which allows access to anyone with a link, and CQ Contacts, which restricts access to authenticated users. A key feature of this system is the auto-sync capability; when a CQ Contact downloads a shared pack, any subsequent updates made by the original owner are automatically reflected in the contact's version upon opening their Memory Explorer. For more detailed instructions, the document refers users to the full CQ Share guide.


id: 972d7c0c-cdbe-4a67-832d-e5a48187bf4c
summary: Section: Use Cases
category: knowledge
created_at: 2026-03-12 13:25:36
source_type: document
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 192:202
content:
Document: Use Cases

The document outlines several practical use cases for organizing and analyzing information within the CitadelQuest ecosystem. Key functionalities include document and book analysis for extracting concepts from PDFs, as well as research tools that allow users to aggregate multiple sources to identify contradictions or reinforcements. Users can build specialized knowledge bases for their Spirits, create themed personal wikis, and extract structured data from web URLs. 

Additionally, the platform enables the transformation of Spirit conversation archives into permanent knowledge. A core feature is relationship discovery, which uses analysis to find deep connections across diverse data sources. Finally, the document highlights the ability to share these curated knowledge graphs with friends, teams, or the public through the CQ Share feature. Overall, the system is designed to help users visualize, connect, and distribute complex information efficiently.


id: c2108434-8b74-46a0-845d-5abb287a9cec
summary: Section: Memory Pack (.cqmpack)
category: knowledge
created_at: 2026-03-12 13:26:03
source_type: document
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 7:17
content:
Document: Memory Pack (.cqmpack)

The document outlines the structure and functionality of Memory Packs (.cqmpack) and Memory Libraries (.cqmlib) within the CitadelQuest ecosystem. Memory Packs serve as self-contained, portable units of knowledge that include flexible tags for filtering and search, as well as the original source content from which the information was extracted. These packs are designed for easy portability, allowing them to be shared seamlessly between different users and Citadels.

Complementing the packs is the Memory Library (.cqmlib), which acts as an organizational framework for grouping multiple Memory Packs together. The library provides users with management tools to enable or disable specific packs, establish search priorities to determine which information is accessed first, and utilize tagging for efficient categorization. Together, these components provide a structured and modular approach to managing and sharing digital knowledge.


id: 84185171-3b5f-487e-b788-38c288c23e88
summary: Section: Memory Library (.cqmlib)
category: knowledge
created_at: 2026-03-12 13:26:24
source_type: document
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 18:23
content:
Document: Memory Library (.cqmlib)

The document defines the Memory Node, which serves as the fundamental unit of knowledge within the Memory Library (.cqmlib) system. Each node is composed of four primary attributes: the core information known as Content, a brief Summary for graph visualization, and a specific Category classification—which includes knowledge, facts, preferences, thoughts, conversations, or internet data. Additionally, each node features an Importance metric that determines its current relevance; this value is subject to decay over time if the memory is not actively accessed.


id: 83873d3c-ac7d-4c56-b222-fd9ecb768d1d
summary: Section: Memory Node Structure
category: knowledge
created_at: 2026-03-12 13:26:51
source_type: document
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 24:31
content:
Document: Memory Node Structure

The document, titled "Memory Node Structure," outlines the organizational framework for memory nodes, specifically focusing on source tracking and relational mapping. A key feature of this structure is the ability to track the origin of each memory, ensuring data integrity and context. Furthermore, the document details how nodes are interconnected through specific relationship types. Currently, it highlights the "RELATES_TO" connection, which signifies a general semantic link between nodes and is visually represented by a blue edge in the system's interface. This structure facilitates a organized, traceable, and visually categorized network of information.


id: e70f4f2c-63c7-4af3-8110-b37bf4eaf28a
summary: Section: Relationship Types
category: knowledge
created_at: 2026-03-12 13:27:18
source_type: document
source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_range: 32:37
content:
Document: Relationship Types

This document outlines three specific relationship types used to categorize and visualize connections between pieces of information. Each relationship is defined by its function and an associated color-coded edge for visual representation. The "REINFORCES" relationship, indicated by a green edge, is used for supporting or confirming information. The "CONTRADICTS" relationship, marked with a red edge, identifies conflicting data. Finally, the "PART_OF" relationship, represented by a white or grey edge, denotes a hierarchical parent-child structure. The document serves as a concise legend for understanding how different data points interact within a system or diagram.


id: ac49a47f-9772-4591-932c-4504d4ce6a1b
summary: Document: 05-file-browser.md
category: knowledge
created_at: 2026-03-12 13:33:40
source_type: document_summary
source_ref: general:/CQ-User-Manual:05-file-browser.md
source_range: 1:87
content:
Document: 05-file-browser.md

The File Browser serves as the personal cloud storage system within the CitadelQuest platform, located at the `/file-browser` route. It provides users with a secure, self-hosted environment where files are stored on their own server and remain inaccessible to other users. The interface features a switchable Tree View for hierarchical navigation and a File Preview pane that displays metadata, action buttons, and content previews for formats such as PDF, images, and Markdown.

Users can perform standard file operations including uploading via drag-and-drop, creating new folders or files, renaming, and deleting. Additionally, the system supports downloading individual files or entire directories as ZIP archives. A sharing feature allows users to generate "CQ Share" links for public access or restricted sharing with specific CQ Contacts.

A key highlight is the deep AI integration, where Spirits utilize specialized tools to read, create, edit, and manage files on the user's behalf. This allows for automated tasks like organizing directories or summarizing uploaded documents. The File Browser is fully responsive for mobile use and provides a storage breakdown on the Dashboard to track usage across database, user data, and backups.


id: 9fc3589c-f983-4f00-8ed1-296e059d7fac
summary: Section: Introduction to File Browser
category: knowledge
created_at: 2026-03-12 13:34:08
source_type: document
source_ref: general:/CQ-User-Manual:05-file-browser.md
source_range: 1:8
content:
Document: Introduction to File Browser

The File Browser serves as a personal cloud storage solution integrated directly within the CitadelQuest platform. Located at the route /file-browser, this tool allows users to store files on their own private server, ensuring data sovereignty and constant accessibility. A key feature of the File Browser is its full integration with AI Spirits, enabling these digital assistants to interact with and manage the user's stored data. It functions as a secure, private alternative to traditional cloud services, keeping all information within the user's decentralized environment.


id: 697c5176-557a-4939-bbbd-f565956940af
summary: Section: Interface and Views
category: knowledge
created_at: 2026-03-12 13:34:29
source_type: document
source_ref: general:/CQ-User-Manual:05-file-browser.md
source_range: 9:22
content:
Document: Interface and Views

The Interface and Views document details the two primary navigation modes available within the File Browser. Users can switch between these modes using toggle buttons to suit their workflow. The Tree View provides a hierarchical representation of the complete folder structure, allowing for easy navigation through expanding and collapsing folders and direct file selection. Complementing this is the File Preview feature, which displays essential metadata such as file size and the last modified date. This view also includes integrated action buttons for downloading, renaming, or deleting files, and offers direct content previews for specific file formats, including images, PDFs, Markdown (md), and plain text (txt) files.


id: ff00df6c-c3e8-4a0d-8fb9-33ee914ccc57
summary: Section: File Operations
category: knowledge
created_at: 2026-03-12 13:34:47
source_type: document
source_ref: general:/CQ-User-Manual:05-file-browser.md
source_range: 23:53
content:
Document: File Operations

The "File Operations" document provides a comprehensive guide on managing data within the CitadelQuest environment. It outlines several core functionalities, starting with the process for uploading files via a dedicated button or drag-and-drop interface. Users can organize their workspace by creating new folders or generating empty files, which can then be edited manually or populated with content by their Spirit. 

The guide also details maintenance tasks such as renaming, deleting, and downloading files. Notably, users have the option to download entire directories as ZIP files. Finally, the document explains the sharing mechanism, where users can generate CQ Share links for their files. These links offer granular privacy controls, allowing for either public access or restricted sharing limited to specific CQ Contacts. This set of tools ensures users have full control over their personal data storage and collaboration capabilities.


id: e3a976b6-6989-4cf5-8a77-b1236d687cd1
summary: Section: AI Integration and Spirit Tools
category: knowledge
created_at: 2026-03-12 13:35:15
source_type: document
source_ref: general:/CQ-User-Manual:05-file-browser.md
source_range: 54:71
content:
Document: AI Integration and Spirit Tools

The document "AI Integration and Spirit Tools" details the functional capabilities of Spirits within the CitadelQuest ecosystem, specifically focusing on their interaction with the File Browser. Spirits are equipped with a suite of AI tools that allow them to read, create, edit, and manage files, as well as browse directory structures to understand a user's data organization. These capabilities enable Spirits to perform practical tasks such as generating shopping lists, summarizing uploaded documents, updating existing files with new information, and organizing files into topic-based folders. This integration ensures that the AI can act as a hands-on assistant for data management and content creation within the user's private environment.


id: d68be241-4b63-4c48-8309-69a2950cf0af
summary: Section: Mobile Support and Storage Architecture
category: knowledge
created_at: 2026-03-12 13:35:41
source_type: document
source_ref: general:/CQ-User-Manual:05-file-browser.md
source_range: 72:87
content:
Document: Mobile Support and Storage Architecture

The document outlines the mobile compatibility and storage architecture of the CitadelQuest File Browser. It highlights that the interface is fully responsive and optimized for mobile devices through touch-friendly controls, icon-based navigation, and layouts that adapt to various screen sizes. Regarding storage, files are kept in a personal data directory on the server, with usage statistics for the database, user data, and backups visible on the Dashboard. A critical security feature is the per-user storage isolation, which ensures that files remain private and inaccessible to other users on the same Citadel.


id: b55220a6-be4e-41cf-a5b2-479ae9733feb
summary: Document: 06-cq-chat.md
category: knowledge
created_at: 2026-03-12 13:37:06
source_type: document_summary
source_ref: general:/CQ-User-Manual:06-cq-chat.md
source_range: 1:55
content:
Document: 06-cq-chat.md

CQ Chat is a private, encrypted messaging feature within the CitadelQuest platform that enables direct communication between users across different instances via a decentralized Federation protocol. By bypassing corporate servers, messages travel straight from one Citadel to another over HTTPS, secured by CQ Contact API Keys, and are stored exclusively on the sender's and receiver's personal databases.

Users can access the service through the /cq-chat route or a navigation dropdown that displays recent conversations, unseen message counts, and a "New Chat" button. The full interface provides a comprehensive view with a conversation list, active message history, and timestamps. Key features include real-time text delivery, group chat support for multiple participants, image attachments, and read indicators. The system utilizes a global updates endpoint to poll for new messages in real-time, ensuring a seamless and secure user experience while maintaining strict data sovereignty and privacy.


id: 3b059a1f-d20f-491f-a5aa-65bba791b45d
summary: Section: Introduction to CQ Chat
category: knowledge
created_at: 2026-03-12 13:37:19
source_type: document
source_ref: general:/CQ-User-Manual:06-cq-chat.md
source_range: 1:8
content:
Document: Introduction to CQ Chat

CQ Chat is a private messaging feature within the CitadelQuest platform that facilitates direct, encrypted communication between users across different instances. The system utilizes a decentralized architecture where messages travel directly from one Citadel to another, bypassing corporate servers to ensure privacy and data sovereignty. This peer-to-peer approach aligns with the platform's commitment to secure, uncensored interaction. Users can access this messaging interface via the specific route /cq-chat. The document emphasizes that the protocol is designed for secure, federation-based communication, maintaining the user's control over their personal data and interactions without third-party oversight.


id: ff4b2e53-5fdb-49c7-a205-48817beab2ff
summary: Section: Accessing the Chat Interface
category: knowledge
created_at: 2026-03-12 13:37:50
source_type: document
source_ref: general:/CQ-User-Manual:06-cq-chat.md
source_range: 9:27
content:
Document: Accessing the Chat Interface

The document "Accessing the Chat Interface" outlines two primary methods for users to access and manage their conversations within the CQ Chat system. 

The first method is through the Navigation Dropdown, accessible by clicking the chat icon in the top navigation bar. This interface provides a quick view of recent conversations, including previews of the latest messages and a green badge indicating the count of unseen messages. It also features a "New Chat" button for initiating new discussions and allows users to open specific conversations directly from the list.

The second method is the Full Chat Page, located at the URL path /cq-chat. This dedicated interface offers a more comprehensive experience, featuring a conversation list on the left side of the screen and the active conversation window on the right. This view provides access to the full message history, including specific timestamps for each message. Together, these options ensure users can efficiently monitor their communications and engage in detailed interactions within the CitadelQuest platform.


id: f77c05d7-f1e2-4d0b-ba3e-2465ee3145a8
summary: Section: Conversation Management and Features
category: knowledge
created_at: 2026-03-12 13:38:04
source_type: document
source_ref: general:/CQ-User-Manual:06-cq-chat.md
source_range: 28:46
content:
Document: Conversation Management and Features

The document "Conversation Management and Features" provides a guide for using the CQ Chat system. It outlines the process for initiating a conversation, which involves clicking the New Chat icon, selecting a contact from the CQ Contacts list, and typing a message. The platform supports both direct messaging and group chats involving participants from various Citadels. Key messaging features include real-time text delivery, the ability to attach images, and the inclusion of timestamps for each message. Additionally, the system provides status tracking through read indicators and an "unseen count" badge to notify users of unread messages. The document serves as a functional overview of the communication tools available within the CitadelQuest ecosystem.


id: 34ad3ed6-59be-4d32-9cd0-792bd512d00c
summary: Section: Technical Architecture and Privacy
category: knowledge
created_at: 2026-03-12 13:38:22
source_type: document
source_ref: general:/CQ-User-Manual:06-cq-chat.md
source_range: 47:55
content:
Document: Technical Architecture and Privacy

The document outlines the technical architecture and privacy framework of CQ Chat, which utilizes the CitadelQuest Federation protocol for cross-instance communication. This decentralized system enables messages to be sent directly between individual Citadels over HTTPS, secured by CQ Contact API Keys. Real-time message delivery is facilitated by browser polling via a global updates endpoint. A core feature of this architecture is its commitment to data sovereignty; messages are stored exclusively on the sender's and receiver's personal databases. By eliminating a central relay server, the system ensures that no intermediary can access or store user communications, maintaining a high standard of privacy and security.


id: e3562b91-45ea-49ec-a6ae-2f1d2c256c3d
summary: Document: 08-cq-share.md
category: knowledge
created_at: 2026-03-12 13:43:29
source_type: document_summary
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 1:211
content:
Document: 08-cq-share.md

CQ Share is a core feature of the CitadelQuest platform that enables users to share files and knowledge with others. Located at the `/share` route, the system supports two primary sharing scopes: Public, which allows access via a clean URL without a login, and CQ Contacts, which requires authentication via API keys. Users can share any file from their File Browser or specialized CQ Memory Packs, which are knowledge graphs that support automatic synchronization between Citadels.

The management interface allows users to track views, toggle the active status of shares, and customize how content is presented using three display styles: Full, Preview, or Hidden. Additionally, users can add Markdown descriptions and adjust their positioning relative to the content. A significant organizational feature is Share Groups, which allows users to categorize shared items into named, icon-coded collections that appear as tabbed navigation on their public profile or in CQ Explorer.

Creating a share is integrated across the platform, accessible from the File Browser, Memory Explorer, or the dedicated Share page. For Memory Packs, the system provides a powerful auto-sync capability, ensuring that contacts who download a pack always receive the latest updates from the source. While shares can be paused or deleted to revoke access, the original underlying files remain securely stored in the user's personal database.


id: 30770643-51d9-4460-8d73-acbeeea5ee5d
summary: Section: Management and Creation
category: knowledge
created_at: 2026-03-12 13:44:49
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 25:72
content:
Document: Management and Creation

The document "Management and Creation" outlines the functionality and procedures for managing and generating shared content within the CitadelQuest ecosystem. The CQ Share management page provides a centralized dashboard where users can monitor their shared items, including files and Memory Packs. This interface displays critical metadata such as titles, sharing scope (Public or CQ Contacts), access URLs, view counters, and current status (Active or Paused). Users can also customize the display style and provide markdown descriptions for their shared content. To facilitate organization, the page includes search and filtering tools based on title, type, and status.

The document also details three primary methods for creating a share. First, users can share directly from the File Browser by selecting a file and configuring its title and scope. Second, shares can be initiated from the Memory Explorer by selecting a specific Memory Pack and using the management dropdown menu. Finally, users can create shares through the dedicated CQ Share page by selecting an item from their File Browser and configuring a custom URL slug. Regardless of the method, the system automatically generates a share URL once the configuration is saved, making the content live according to the defined access permissions.


id: d92f6c51-6e01-479d-83ca-d660824e27b7
summary: Section: URLs and Display Configuration
category: knowledge
created_at: 2026-03-12 13:45:29
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 73:113
content:
Document: URLs and Display Configuration

This document outlines the configuration options for sharing items within the CitadelQuest platform, focusing on URL structures, display styles, and descriptions. Each shared item is assigned a clean, customizable URL based on the user's domain and username. Public shares are accessible via these links and display inline by default, though a download can be forced using a specific URL parameter. Conversely, shares intended for specific CQ Contacts require authentication.

Users can control how their shared content appears on their profile and in the CQ Explorer through three primary display styles: Full, which renders content like images and HTML inline; Preview, which provides compact excerpts and thumbnails; and Hidden, which lists the item without a content preview. These styles can be managed individually or overridden at a group level. Additionally, users can add Markdown-based descriptions to their shares. The layout of these descriptions is highly flexible, allowing for placement above, below, or to either side of the primary content to customize the visual presentation for visitors.


id: a4102387-181b-467a-9de7-edeb48f554e0
summary: Section: URLs and Display Configuration
category: knowledge
created_at: 2026-03-12 13:45:53
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 73:113
content:
Document: URLs and Display Configuration

This document outlines the configuration options for shared items within the CitadelQuest platform, focusing on URL structures, display styles, and descriptions. Each shared item is assigned a unique, readable URL based on the user's domain and a customizable slug. Public shares are accessible via link and display inline by default, though a download can be forced using a specific URL parameter. In contrast, shares intended for specific CQ Contacts require authentication.

Users can manage how their content appears on their profile and in the CQ Explorer through three distinct display styles: Full, which renders content inline with full-size images and visualizations; Preview, which provides compact excerpts and thumbnails; and Hidden, which lists the item without a content preview. These styles can be applied individually or managed at a group level. Additionally, users can enhance shared items with Markdown-based descriptions. The layout of these descriptions is highly flexible, allowing for placement above, below, or to either side of the primary content to suit the user's presentation needs.


id: 8e27dea4-f026-4ea9-80ac-c4a850cc64c2
summary: Section: Share Groups and Profile Content
category: knowledge
created_at: 2026-03-12 13:46:06
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 114:153
content:
Document: Share Groups and Profile Content

Share Groups, managed under the Profile Content section of CitadelQuest settings, allow users to organize shared items into named and ordered collections. These groups function as tabbed navigation elements on a user's public profile and within the CQ Explorer. To create a group, users navigate to the settings route and configure details such as the group title, icon, color, URL slug, and visibility levels, which range from public access to specific contacts.

Once a group is established, users can populate it by selecting existing active shares and dragging them to set a specific display order. The system provides granular control over how items appear within a group, offering options to inherit the original share's style or override it with Full, Preview, or Hidden display modes. Ultimately, these groups enhance the user experience by providing a structured, visual way for visitors to browse different sections of a profile, utilizing icons and titles to distinguish between various content categories like introductions or projects.


id: 4d8a2d04-0376-4274-818b-160b12166db4
summary: Section: Share Groups and Profile Content
category: knowledge
created_at: 2026-03-12 13:46:39
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 114:153
content:
Document: Share Groups and Profile Content

Share Groups, managed under the Profile Content section of CitadelQuest settings, allow users to organize shared items into named and ordered collections. These groups function as tabbed navigation on a user's public profile and within the CQ Explorer. To create a group, users navigate to the settings route `/settings/share-groups`, where they can configure the group title, icon, color, and a URL-friendly slug. Visibility settings are flexible, allowing groups to be set as Public, restricted to CQ Contacts, or limited to specific individuals.

Once a group is created, users can add existing active shares and drag them to reorder the content. The system provides granular display controls, allowing users to inherit the original share's style or override it with Full, Preview, or Hidden settings for that specific group. Visually, these groups appear as interactive tabs below the profile header on public pages and within the main content area of the CQ Explorer, utilizing the chosen icons and titles to help visitors browse different sections of the user's shared content.


id: 6da2a708-27d5-48a6-b43a-18ca0e7749c6
summary: Section: Share Groups and Profile Content
category: knowledge
created_at: 2026-03-12 13:46:39
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 114:153
content:
Document: Share Groups and Profile Content

Share Groups, managed under the Profile Content section of CitadelQuest settings, allow users to organize shared items into named and ordered collections. These groups function as tabbed navigation on a user's public profile and within the CQ Explorer. To create a group, users navigate to the settings route `/settings/share-groups`, where they can configure the group title, icon, color, URL slug, and visibility levels—ranging from Public to specific CQ Contacts.

Once a group is created, users can add existing active shares and drag them to reorder the content. The system provides granular display controls, allowing users to inherit the original share's style or override it with Full, Preview, or Hidden settings specifically for that group. On the front end, these groups are presented as interactive tabs below the profile header, enabling visitors to browse different sections of content, such as introductions or projects, with ease. This feature enhances the presentation of a user's personal Citadel by providing a structured, visual way to showcase information and files.


id: f090a573-effa-4c9a-9a8f-b17da18cb3bc
summary: Section: Memory Pack Auto-Sync
category: knowledge
created_at: 2026-03-12 13:46:52
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 154:173
content:
Document: Memory Pack Auto-Sync

The document "Memory Pack Auto-Sync" outlines the functionality and practical applications of the auto-sync feature within the CitadelQuest (CQ) ecosystem. This feature allows for the seamless distribution and maintenance of shared knowledge across different Citadels.

The process begins when a user shares a Memory Pack via CQ Share. Once a CQ Contact downloads this pack to their own Citadel, the system retains a connection to the source URL. This link enables the downloaded pack to automatically check for updates every time the recipient opens their Memory Explorer. If the original creator adds new information or knowledge to the source pack, those updates are synchronized automatically to the contact's version.

Key use cases for this technology include maintaining shared knowledge bases where contacts always possess the most current information, managing team documentation for projects, and distributing curated learning materials or knowledge graphs to friends and students. By leveraging auto-sync, CQ ensures that collaborative data remains consistent and up-to-date across the decentralized network without requiring manual downloads for every update.


id: 02619512-3802-40c7-9fd4-13edfcdbf655
summary: Section: Maintenance and Lifecycle
category: knowledge
created_at: 2026-03-12 13:47:14
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 174:195
content:
Document: Maintenance and Lifecycle

The document "Maintenance and Lifecycle" outlines the procedures for managing shared content within the CitadelQuest platform. It details three primary actions: editing, pausing, and deleting shares. When editing a share, users can modify the title, URL slug, visibility scope (Public or CQ Contacts), and display style. Additionally, users can update the optional markdown description and its layout position. Pausing a share toggles its status to inactive, which results in a 404 error for viewers without deleting the underlying data. Similarly, deleting a share entry removes the access link but ensures the original file or memory pack remains intact within the user's File Browser. The guide emphasizes that these lifecycle management tools only affect the sharing metadata and accessibility, preserving the source content throughout all administrative changes.


id: 4f70c9b8-0c82-4597-a99f-d1ca8c7962b9
summary: Section: Memory Pack Auto-Sync
category: knowledge
created_at: 2026-03-12 13:47:29
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 154:173
content:
Document: Memory Pack Auto-Sync

The document "Memory Pack Auto-Sync" explains the automated synchronization feature within the CitadelQuest (CQ) ecosystem. This functionality allows shared Memory Packs to remain updated across different Citadels without manual intervention. The process begins when a user shares a Memory Pack via CQ Share and a contact downloads it. Because the downloaded pack retains a reference to its source URL, it automatically checks for updates every time the recipient opens their Memory Explorer. If the original creator adds new knowledge or modifications, those changes are synced to the contact's version automatically.

The document highlights several practical use cases for this technology, including the maintenance of shared knowledge bases, the distribution of up-to-date team documentation for projects, and the sharing of curated learning materials or knowledge graphs with students and friends. Ultimately, auto-sync ensures that all collaborators and contacts possess the most current version of information, fostering seamless knowledge sharing and consistency across the decentralized network.


id: 4c65b13b-e579-4e5b-99c1-8c216affde3b
summary: Section: Memory Pack Auto-Sync
category: knowledge
created_at: 2026-03-12 13:47:29
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 154:173
content:
Document: Memory Pack Auto-Sync

The document "Memory Pack Auto-Sync" outlines the functionality and practical applications of the auto-sync feature within CitadelQuest's Memory Pack sharing system. The process begins when a user shares a Memory Pack via CQ Share, which a CQ Contact then downloads to their own Citadel. Because the downloaded pack retains its source URL, it possesses the ability to automatically check for updates whenever the recipient opens their Memory Explorer. If the original creator adds new knowledge or updates the source pack, these changes are synchronized automatically to the contact's version.

The document highlights several key use cases for this technology, emphasizing its utility in maintaining shared knowledge bases where contacts always require the latest information. It is also presented as an effective tool for team documentation, ensuring project knowledge remains current across different Citadels. Additionally, the feature is ideal for educational purposes, allowing for the distribution of curated learning materials and knowledge graphs to friends or students that stay up to date without manual intervention. This system ensures seamless information flow and data consistency between collaborators within the CitadelQuest ecosystem.


id: 1d3da196-26b2-4575-8d68-23713a1ac801
summary: Section: Profile Integration and CQ Explorer
category: knowledge
created_at: 2026-03-12 13:47:42
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 196:211
content:
Document: Profile Integration and CQ Explorer

This document outlines how public shares are integrated into a user's CQ Profile and accessed via the CQ Explorer. Users with an enabled public profile page can display their shared content in two formats: organized Share Groups, which use tabbed sections, or a flat Shared items list. These display options can be toggled independently within the profile visibility settings. Additionally, the CQ Explorer allows users to browse other profiles to view their public shared items and content groups. Through this interface, users can directly download files and Memory Packs from other profiles to their own Citadel. The integration facilitates seamless content discovery and data portability between different users within the CitadelQuest ecosystem.


id: ff9a208f-151d-43df-9869-4df9f9dd2f1a
summary: Section: Maintenance and Lifecycle
category: knowledge
created_at: 2026-03-12 13:47:57
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 174:195
content:
Document: Maintenance and Lifecycle

The document "Maintenance and Lifecycle" outlines the procedures for managing shared content within the CitadelQuest ecosystem. It details three primary actions: editing, pausing, and deleting shares. When editing, users can modify the share's title, URL slug, and description, as well as adjust the visibility scope between Public and CQ Contacts. Users also have control over the display style and the positioning of the description text.

The document explains that shares can be toggled between active and paused states; pausing a share makes it return a 404 error without deleting the underlying data. Similarly, deleting a share entry removes the access link but ensures the original file or memory pack remains intact within the user's File Browser. This system allows for flexible management of shared resources while maintaining data integrity and security.


id: de432f8f-e033-4e6e-a579-b189ccd74095
summary: Section: CQ Share Management Page Overview
category: knowledge
created_at: 2026-03-12 13:48:03
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 25:37
content:
Document: CQ Share Management Page Overview

The CQ Share Management Page Overview document outlines the specific procedures for sharing content within the CitadelQuest ecosystem. Users can initiate sharing from two primary locations: the File Browser and the Memory Explorer. When sharing from the File Browser, a user selects a file and uses the share action button to define a title and set the visibility scope to either Public or CQ Contacts, which triggers the automatic generation of a shareable URL. Similarly, through the Memory Explorer, users can select a specific Memory Pack and utilize the management dropdown menu to access the sharing interface. In both workflows, the user is required to designate a title and determine the accessibility scope to manage how their data is distributed. This process ensures that both files and memory assets can be securely shared with specific contacts or the broader public according to the user's preference.


id: c948f87d-5941-4d4d-84a2-98e896b44105
summary: Section: Profile Integration and CQ Explorer
category: knowledge
created_at: 2026-03-12 13:48:18
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 196:211
content:
Document: Profile Integration and CQ Explorer

The document outlines how public shares are integrated into the CQ Profile and accessed via the CQ Explorer. Users with an enabled public page can display their shared content in two distinct ways: through organized Share Groups, which utilize tabbed sections for better structure, or via a flat Shared items list. These display options can be toggled independently within the profile visibility settings. Furthermore, the CQ Explorer allows users to browse these public shares on other profiles, facilitating the direct download of files and Memory Packs to their own Citadel. This integration ensures that shared content is both manageable for the profile owner and easily accessible for other users within the ecosystem.


id: 7aad6489-13dd-456e-8007-5a38afcbac2e
summary: Section: Search & Filter Functionality
category: knowledge
created_at: 2026-03-12 13:48:20
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 38:46
content:
Document: Search & Filter Functionality

This document outlines the step-by-step process for utilizing the search and filter functionality within the CQ Share page. To initiate a share, users must navigate to the specific share route, select the "Create New Share" option, and choose the desired file or memory pack directly from their personal File Browser. The configuration process involves setting a title, defining the scope of access, and establishing a custom URL slug. Once these settings are saved, the shared content becomes live and accessible based on the defined parameters.


id: 033b4c10-b865-4082-b222-2b80e3325247
summary: Section: CQ Share Management Page Overview
category: knowledge
created_at: 2026-03-12 13:48:45
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 25:37
content:
Document: CQ Share Management Page Overview

The CQ Share Management Page Overview document outlines the specific procedures for sharing digital assets within the CitadelQuest ecosystem. Users can initiate sharing from two primary locations: the File Browser and the Memory Explorer. 

When sharing from the File Browser, a user selects a specific file and utilizes the share button within the file actions menu. For sharing via the Memory Explorer, the user selects a Memory Pack and accesses the share option through the pack management dropdown menu. Regardless of the starting point, the process requires the user to define a title and set a visibility scope, which can be configured for either the general public or restricted to specific CQ Contacts. Once these parameters are set, the system automatically generates a unique share URL for distribution. The document serves as a functional guide for managing data accessibility and collaboration across different modules of the platform.


id: a29723a7-9d66-433d-b3a3-a3b448dfc2e0
summary: Section: Methods for Creating Shares
category: knowledge
created_at: 2026-03-12 13:48:47
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 47:48
content:
Document: Methods for Creating Shares

The provided document, titled "Methods for Creating Shares," contains no substantive content or descriptive text beyond its header and structural markers. As the body of the document is empty, it does not outline any specific techniques, protocols, or procedures regarding the creation of digital or financial shares. Consequently, no factual summary of methods can be generated from this source.


id: d0105e38-e572-40e8-9841-f88321a97df3
summary: Section: Search & Filter Functionality
category: knowledge
created_at: 2026-03-12 13:49:12
source_type: document
source_ref: general:/CQ-User-Manual:08-cq-share.md
source_range: 38:46
content:
Document: Search & Filter Functionality

This document outlines the step-by-step process for utilizing the search and filter functionality within the CQ Share page. To initiate a share, a user navigates to the share section of the platform and selects the option to create a new entry. The process involves choosing specific content, such as a file or a memory pack, directly from the user's personal File Browser. Once the content is selected, the user must configure essential metadata, including the title, the visibility scope, and a custom URL slug. After saving these configurations, the share becomes active and accessible. The guide serves as a functional walkthrough for managing and deploying shared assets within the CitadelQuest ecosystem.


id: 6f6281f0-0ae6-4ec8-b829-a07b383d2baa
summary: Document: 11-backup.md
category: knowledge
created_at: 2026-03-12 14:04:39
source_type: document_summary
source_ref: general:/CQ-User-Manual:11-backup.md
source_range: 1:65
content:
Document: 11-backup.md

The document "11-backup.md" outlines the comprehensive backup and restore system within CitadelQuest, accessible via the /backup route. This system allows users to protect their data by creating .citadel ZIP files, which package the personal database—including settings, conversations, and memories—alongside all user files stored in the File Browser. Users can manage these backups through several key actions: creating new backups, downloading them for off-site storage or migration preparation, and uploading existing files using a chunked uploading method to prevent timeouts with large files.

The restoration process involves confirming a restore action, which replaces the current database and user files with the version from the backup, followed by a page refresh. Users can also delete backups to manage server storage space. The document concludes with best practices, recommending regular backups, keeping local copies on external devices, and performing a fresh backup before any account migration or system update. Users are also encouraged to monitor their storage usage through the Dashboard to ensure sufficient space for these files.


id: f10414d1-5c2c-4f68-9977-d71212e8d9af
summary: Section: Introduction to Backup & Restore
category: knowledge
created_at: 2026-03-12 14:05:00
source_type: document
source_ref: general:/CQ-User-Manual:11-backup.md
source_range: 1:8
content:
Document: Introduction to Backup & Restore

The document "Introduction to Backup & Restore" outlines the data protection capabilities within the CitadelQuest platform. It specifies that the system provides a comprehensive backup utility allowing users to create, download, upload, and restore their data at their convenience. This functionality is designed to ensure data security and user sovereignty over their information. Users can access these features through the specific system route located at /backup.


id: ce8748d3-07f3-458d-b031-05996cd7ecc8
summary: Section: Creating a Backup
category: knowledge
created_at: 2026-03-12 14:05:27
source_type: document
source_ref: general:/CQ-User-Manual:11-backup.md
source_range: 9:20
content:
Document: Creating a Backup

The document "Creating a Backup" provides a concise guide for users to secure their data within the CitadelQuest platform. To initiate the process, users must navigate to the Backup section (/backup) and select the "Create Backup" option. The system then packages all essential user information into a single archive, including the personal database—which contains settings, conversations, memories, and contacts—as well as all user data files stored in the File Browser. Once the packaging process is finished, the backup is displayed in the user's backup list. These backups are saved on the server in the user's personal backup directory as ZIP files with a .citadel extension, ensuring that all personal data and configurations are preserved and accessible for recovery.


id: 10447049-2745-48a8-a44e-219768498463
summary: Section: Downloading and Uploading Backups
category: knowledge
created_at: 2026-03-12 14:05:54
source_type: document
source_ref: general:/CQ-User-Manual:11-backup.md
source_range: 21:40
content:
Document: Downloading and Uploading Backups

This document provides instructions for managing CitadelQuest backups through downloading and uploading procedures. Users can download backups to their local devices by clicking the "Download" button, a practice recommended for off-site storage, account migrations, or as a safety measure before performing major updates. To upload a backup, users must select a ".citadel" ZIP file from their device using the "Upload Backup" feature. For larger files, the system utilizes chunked uploading, which splits the data into smaller pieces to be reassembled on the server, effectively preventing timeout issues during the transfer process.


id: b0814698-e1bf-405e-bbd0-89be0c75d3a2
summary: Section: Restoring and Deleting Backups
category: knowledge
created_at: 2026-03-12 14:06:21
source_type: document
source_ref: general:/CQ-User-Manual:11-backup.md
source_range: 41:57
content:
Document: Restoring and Deleting Backups

This document provides instructions for managing backups within the CitadelQuest platform, specifically covering the restoration and deletion processes. To restore a backup, users must click the "Restore" button next to their chosen file and confirm the action. During this process, CitadelQuest automatically restores both the database and the user's data files. Once the restoration is finished, the user should refresh the page to complete the update. Additionally, the document notes that users can permanently remove backups to free up storage space by clicking the "Delete" button next to any specific backup entry.


id: 96095a4e-b62c-475e-a2aa-80fa6ee37e4d
summary: Section: Best Practices
category: knowledge
created_at: 2026-03-12 14:06:48
source_type: document
source_ref: general:/CQ-User-Manual:11-backup.md
source_range: 58:65
content:
Document: Best Practices

The document outlines essential best practices for data management and security within the CitadelQuest platform, focusing primarily on backup procedures. It emphasizes the importance of performing regular backups, particularly before initiating system updates or account migrations, to prevent data loss. Users are advised to maintain redundancy by downloading copies of these backups to local devices or external storage solutions. Additionally, the guide highlights the necessity of monitoring storage capacity through the Dashboard's Storage Usage panel to ensure backup sizes remain within manageable limits. Following these protocols ensures data integrity and a smooth transition during technical changes.


id: 1f4aba06-d24c-48de-90c1-a09640942ada
summary: Document: 12-administration.md
category: knowledge
created_at: 2026-03-12 14:09:31
source_type: document_summary
source_ref: general:/CQ-User-Manual:12-administration.md
source_range: 1:111
content:
Document: 12-administration.md

The document "12-administration.md" outlines the features and functionalities of the CitadelQuest Administration panel, accessible to users with Admin privileges at the `/administration` route. The first registered user on an installation is automatically granted admin status. The Admin Dashboard provides a central hub for user statistics, quick actions, and a list of recently registered users.

Key administrative areas include User Management, where admins can search for users, reset passwords, toggle admin roles, or delete accounts. The Application Updates section allows admins to check for GitHub updates and initiate an automated update process that includes safety backups, file updates, and database migrations. System Settings provide controls for enabling or disabling user registration, setting maximum user limits, and configuring a homepage redirect that points unauthenticated visitors to a specific user's public CQ Profile.

Additional technical tools include Server Logs for viewing, downloading, or clearing system logs, and System Backups for managing backup files across all users. Finally, the Migration Requests section allows admins to accept or reject incoming account transfer requests from users on other Citadels. The guide emphasizes the importance of manual backups before performing system updates.


id: fe4eef3d-8d4f-4188-986c-39a43ca9913b
summary: Section: Introduction and Admin Dashboard
category: knowledge
created_at: 2026-03-12 14:09:52
source_type: document
source_ref: general:/CQ-User-Manual:12-administration.md
source_range: 1:17
content:
Document: Introduction and Admin Dashboard

The "Introduction and Admin Dashboard" document outlines the core functionality and accessibility of the CitadelQuest Administration panel. Access to this panel is restricted to users with Admin privileges, a status automatically granted to the first person who registers on a new installation. The panel is located at the specific route `/administration`.

The Admin Dashboard serves as a central hub for system oversight, providing three primary categories of information and control. First, it displays user statistics, including the total number of users and recent registration data. Second, it offers quick actions that link directly to essential administrative tasks such as user management, system updates, and general settings. Finally, the dashboard includes a table listing recently registered users for easy monitoring. This document serves as a foundational guide for administrators to navigate and manage their CitadelQuest instance effectively.


id: e3bcb9b7-f7cb-48b2-b798-50ecd96d781c
summary: Section: User Management
category: knowledge
created_at: 2026-03-12 14:10:14
source_type: document
source_ref: general:/CQ-User-Manual:12-administration.md
source_range: 18:35
content:
Document: User Management

The User Management document outlines the administrative functionalities available at the /administration/users route within a Citadel. This interface allows administrators to oversee all registered users through a comprehensive User List, which displays essential data such as usernames, email addresses, assigned roles, and registration dates. To facilitate efficient management, a search feature is included to filter the list by name or email.

The document details four primary User Actions available to administrators. "View Info" opens a modal dialog containing specific user details. "Toggle Admin" allows for the granting or revoking of administrative privileges, though safety protocols prevent users from removing their own admin status. "Reset Password" enables the generation of new credentials for any user. Finally, the "Delete User" function permits the permanent removal of a user and their associated data. To ensure system stability and security, the platform prohibits a user from deleting themselves or removing the final administrator on the Citadel.


id: e233a100-5775-4040-a1b3-7b3fe93470da
summary: Section: Application Updates
category: knowledge
created_at: 2026-03-12 14:10:42
source_type: document
source_ref: general:/CQ-User-Manual:12-administration.md
source_range: 36:55
content:
Document: Application Updates

The document outlines the process for checking and installing updates within the CitadelQuest application via the administration route. The update procedure follows a structured four-step sequence initiated by checking for new versions on GitHub. Once a new version is identified, the automated updater performs several critical tasks: it generates a safety backup, downloads the necessary files, and applies updates while ensuring that the user's specific .env configuration remains preserved. Furthermore, the system handles technical maintenance by running database migrations and performing cache management (clearing and warming up) to ensure stability. After the process is complete, a page refresh is required to activate the new version. The document concludes with a security recommendation, advising users to perform a manual backup prior to starting any update as an additional precaution.


id: 2a74f7ec-6dc6-4e4b-a87a-5ce5de772401
summary: Section: System Settings and Homepage Redirect
category: knowledge
created_at: 2026-03-12 14:11:09
source_type: document
source_ref: general:/CQ-User-Manual:12-administration.md
source_range: 56:78
content:
Document: System Settings and Homepage Redirect

This document outlines the system-level configuration options available within the admin dashboard for managing user access and homepage behavior. The "User Registration" section details how administrators can toggle new sign-ups on or off and set a maximum user limit to control the Citadel's growth. When registration is disabled, prospective users encounter a notification message. 

The "Homepage Redirect" feature allows administrators to customize the experience for unauthenticated visitors. By selecting a registered user and enabling the redirect, the Citadel’s root URL will automatically point to that individual's public CQ Profile page. This functionality is designed to transform the domain into a personal website or landing page for external visitors, while ensuring that authenticated users are still directed to their private Dashboard upon arrival. Together, these settings provide essential tools for managing both the security and the public-facing identity of a CitadelQuest instance.


id: 485942bf-31ec-4d61-9bc2-b3f9777e1844
summary: Section: Logs and Backups
category: knowledge
created_at: 2026-03-12 14:11:32
source_type: document
source_ref: general:/CQ-User-Manual:12-administration.md
source_range: 79:101
content:
Document: Logs and Backups

The "Logs and Backups" document outlines the administrative functionalities for managing server data and system security within the platform. It is divided into two primary sections: Server Logs and System Backups.

The Server Logs section, located at the `/administration/logs` route, provides tools for monitoring system activity. Administrators can list all log files, viewing their size and last modified dates. The interface supports viewing specific file contents through tail/head navigation, downloading logs for offline analysis, and clearing files to manage storage space.

The System Backups section, found at `/administration/system-backups`, focuses on global data preservation. This area allows administrators to manage backup files across all users. Key capabilities include viewing all existing user backups, deleting obsolete or unnecessary files, and monitoring overall backup storage usage. Together, these tools ensure that administrators can maintain system health, perform troubleshooting, and oversee data redundancy across the entire environment.


id: 6c522150-ff8d-42ac-a776-58f6699ff927
summary: Section: Migration Requests
category: knowledge
created_at: 2026-03-12 14:12:00
source_type: document
source_ref: general:/CQ-User-Manual:12-administration.md
source_range: 102:111
content:
Document: Migration Requests

The document titled "Migration Requests" outlines the administrative procedures for managing user transfers between different Citadels via the route `/administration/migrations`. It details the specific actions an administrator can take when receiving requests from external users who wish to migrate their accounts to the current instance. Key functionalities include the ability to view all incoming requests, accept them to facilitate a full account transfer, or reject them to decline the migration. Additionally, the interface allows administrators to monitor the real-time progress and status of ongoing migrations to ensure the process is completed successfully.


id: adcf2a61-15b8-45d5-a10d-3f0ff414bff0
summary: Document: 13-installation.md
category: knowledge
created_at: 2026-03-12 14:13:54
source_type: document_summary
source_ref: general:/CQ-User-Manual:13-installation.md
source_range: 1:115
content:
Document: 13-installation.md

The document "13-installation.md" provides a comprehensive guide for deploying a personal CitadelQuest instance, emphasizing data sovereignty and privacy. To run the platform, servers require PHP 8.4 or higher, Apache with mod_rewrite, SQLite3, and mandatory HTTPS. The software is compatible with shared hosting, VPS, or dedicated servers, and also offers a Dockerfile for containerized deployment.

The primary installation method is a "Zero-Click" process involving downloading a small installer package from GitHub, uploading `install.php` to a web server, and running it via a browser. This automated script handles downloading the full release, extraction, and directory setup. Once installed, the first registered user is granted Admin privileges. Configuration is managed through a `.env` file, which stores environment settings and database paths while remaining protected during updates.

Post-installation features include an Admin Dashboard for automated updates with safety backups, PWA support for mobile and desktop use, and multi-user capabilities where each user’s data is isolated in a personal SQLite database. To enable AI functionality, users must connect to the CQ AI Gateway, which can be done automatically during registration or manually via an API key. The document concludes by noting that new users receive starting credits for AI services, with options to add more as needed.


id: 02219640-3973-4d9f-bbb1-5c2f490ed3b5
summary: Section: Introduction and Server Requirements
category: knowledge
created_at: 2026-03-12 14:14:06
source_type: document
source_ref: general:/CQ-User-Manual:13-installation.md
source_range: 1:17
content:
Document: Introduction and Server Requirements

This document outlines the initial steps and technical prerequisites for installing a personal instance of CitadelQuest, a platform designed to give users complete control over their data and privacy. By running their own "Citadel," users ensure that their server and rules govern their personal information. The system is compatible with various hosting environments, including shared web hosting, Virtual Private Servers (VPS), and dedicated servers.

To successfully deploy the software, the server must meet specific technical requirements: it must run PHP 8.4 or higher and utilize an Apache web server with the mod_rewrite module enabled. Essential PHP extensions include SQLite3 for database management, along with mbstring, intl, json, and zip. Additionally, a secure HTTPS connection is strictly required to ensure the integrity and security of the installation. The document emphasizes that self-hosting is the primary method for achieving true data sovereignty within the CitadelQuest ecosystem.


id: aa033ef6-d33a-4289-9fbb-fb893247be20
summary: Section: Installation Methods
category: knowledge
created_at: 2026-03-12 14:14:20
source_type: document
source_ref: general:/CQ-User-Manual:13-installation.md
source_range: 18:52
content:
Document: Installation Methods

The document outlines two primary methods for installing CitadelQuest: the Zero-Click Installer and a Docker-based deployment. The Zero-Click process is designed for simplicity, requiring the user to download a small installer package from GitHub, upload the install.php file to a web server's public directory, and run it via a browser. This automated script handles downloading the latest release, extracting files, and setting up the directory structure. Once complete, the user registers their first account, which is granted Admin privileges, and follows an onboarding wizard to configure the CQ AI Gateway and create their first Spirit. Alternatively, users seeking a containerized environment can utilize the provided Dockerfile, with specific instructions located in the repository's docker/README.md. The guide emphasizes a streamlined setup to get a personal Citadel operational with minimal manual configuration.


id: e47091aa-4b2b-4925-a2ed-f156fb58e4a9
summary: Section: Configuration and Domain Setup
category: knowledge
created_at: 2026-03-12 14:15:04
source_type: document
source_ref: general:/CQ-User-Manual:13-installation.md
source_range: 53:73
content:
Document: Configuration and Domain Setup

This document outlines the essential configuration and domain setup procedures for a CitadelQuest installation. Key settings are managed via the .env file located in the installation root, which includes the environment status (APP_ENV), a unique APP_SECRET, and the DATABASE_URL, which defaults to a local SQLite path. This configuration file is designed to be preserved during system updates to prevent data loss. For domain integration, users are advised to point their domain to the installation directory and ensure HTTPS is active, utilizing services like Let's Encrypt for certificates. Technical requirements include enabling Apache's mod_rewrite to route traffic through the public index file and ensuring Cloudflare users utilize Full SSL mode for proper connectivity and security.


id: fcec0402-59ac-42bb-b213-6d2270fce582
summary: Section: Maintenance and Updates
category: knowledge
created_at: 2026-03-12 14:15:21
source_type: document
source_ref: general:/CQ-User-Manual:13-installation.md
source_range: 74:85
content:
Document: Maintenance and Updates

The Maintenance and Updates document outlines the standardized procedure for managing system updates through the Admin Dashboard. The process is designed for ease of use and data safety, beginning with a manual check for updates within the Administration section. Once initiated, the updater automatically handles the download and application of the new version. To prevent data loss, the system generates a safety backup before any changes are made. The update cycle concludes with automatic database migrations and the clearing and rebuilding of the system cache to ensure optimal performance and compatibility with the new version.


id: 6d45f077-3b4a-43a8-9e58-bc3da291393c
summary: Section: PWA and Multi-User Support
category: knowledge
created_at: 2026-03-12 14:15:37
source_type: document
source_ref: general:/CQ-User-Manual:13-installation.md
source_range: 86:105
content:
Document: PWA and Multi-User Support

The document outlines the Progressive Web App (PWA) capabilities and multi-user architecture of the CitadelQuest platform. It highlights that CitadelQuest functions as a PWA, allowing users to install it on Android, iOS, and desktop devices for a fullscreen, app-like experience that includes offline access to cached content. Furthermore, the platform supports multiple users on a single installation while maintaining strict data sovereignty. Each user is assigned a completely isolated SQLite database to ensure privacy. Administrative features include the ability to manage user accounts, reset passwords, toggle registration settings, and configure specific storage limits for the Citadel.


id: fdba9b8b-d1a7-475c-bf84-03db9e868a65
summary: Section: CQ AI Gateway Integration
category: knowledge
created_at: 2026-03-12 14:15:50
source_type: document
source_ref: general:/CQ-User-Manual:13-installation.md
source_range: 106:115
content:
Document: CQ AI Gateway Integration

The CQ AI Gateway is a specialized service designed to provide CitadelQuest Spirits with access to advanced AI Large Language Models. Integration can be handled automatically during the user registration process if the "Auto-create CQ AI Gateway accounts" option is selected, or manually by entering an API key within the AI Services section of the application settings. To facilitate immediate use, new users are provided with free starting credits. If additional usage is required, users can purchase more credits through the "Add Credits" button. Further details regarding the service can be found at the official website, cqaigateway.com.


id: c7bcab28-6c5c-485a-a66f-455bf5f892d6
summary: Document: 10-settings.md
category: knowledge
created_at: 2026-03-22 12:52:04
source_type: document_summary
source_ref: general:/CQ-User-Manual:10-settings.md
source_range: 1:135
content:
Document: 10-settings.md

The document "10-settings.md" provides a comprehensive guide to the Settings page of the CitadelQuest platform, located at the `/settings` route. It details how users can manage their personal configuration, AI services, and social presence across several key categories.

General Settings allow users to view their read-only username, update email and password credentials, and select visual background themes. Technical maintenance options include monitoring the personal SQLite database size and running an optimization tool to reclaim space. A significant feature is Account Migration, which enables users to transfer their entire database, files, and settings to a different CitadelQuest instance via a backup and confirmation process.

The AI Services section manages the connection to the CQ AI Gateway. Users can select primary and secondary AI models, compare model capabilities and pricing, and manage their API keys and credit balances.

Social and visibility settings are split into several areas: the CQ Profile section controls the public identity page, including bio, photos, and "Spirit" showcase preferences; Profile Content allows for the organization of shared items into themed groups; and the CQ Feed settings manage both personal publishing channels and subscriptions to feeds from other users. The document concludes by outlining the sidebar navigation for quick access to these various configuration modules.


id: 9a5e7dae-6538-4f70-b79c-89190537784c
summary: Section: Introduction and General Settings
category: knowledge
created_at: 2026-03-22 12:52:32
source_type: document
source_ref: general:/CQ-User-Manual:10-settings.md
source_range: 1:38
content:
Document: Introduction and General Settings

The Settings page, located at the /settings route, serves as the central hub for configuring the CitadelQuest user experience. It encompasses four primary categories: Login Information, Theme, Database management, and Account Migration. Users can view their read-only username and update their email or password through secure modal dialogs. The interface features a dark cyber-themed design with a specific green accent color, which users can further customize by switching between different background themes.

For technical maintenance, the page displays the current size of the user's personal SQLite database and provides an "Optimize Database" tool to reclaim space and enhance performance. A significant feature is the Account Migration tool, which allows users to move their entire digital presence—including databases, files, and settings—to a different CitadelQuest instance. This process requires selecting a destination server where the user has administrative rights, choosing a backup, and confirming with a password. Upon migration, the system automatically notifies contacts of the new address and disables the account on the original server. For users with large amounts of data, the document recommends creating a manual backup prior to migration to ensure reliability.


id: dc79f516-1d98-4380-a139-164c40e0536f
summary: Section: AI Services
category: knowledge
created_at: 2026-03-22 12:52:52
source_type: document
source_ref: general:/CQ-User-Manual:10-settings.md
source_range: 39:61
content:
Document: AI Services

The "AI Services" document outlines the configuration and management of artificial intelligence within the CitadelQuest platform, accessible via the `/settings/ai` route. It details two primary categories of settings: AI Models and the CQ AI Gateway Connection.

Under AI Models, users can designate a Primary AI Model for Spirit conversations and a Secondary AI Model for specialized tasks like image generation. The system includes an "Update Models List" feature to sync with the CQ AI Gateway. A dedicated AI Model Comparison interface allows users to evaluate available models based on provider, capabilities (text, image, or code), context window size, and token pricing.

The CQ AI Gateway Connection section manages the user's integration with the central service. This includes the API Key, which is automatically configured during registration, and a display of the user's current credit balance. Users can purchase additional credits via the "Add Credits" option or access the Gateway Dashboard for a seamless login to the full web interface. The document serves as a guide for users to customize their AI experience and manage the financial aspects of their AI usage.


id: 5ebdf78e-1849-452d-9714-a73038529ca7
summary: Section: CQ Profile and Visibility
category: knowledge
created_at: 2026-03-22 12:53:05
source_type: document
source_ref: general:/CQ-User-Manual:10-settings.md
source_range: 62:83
content:
Document: CQ Profile and Visibility

The "CQ Profile and Visibility" document outlines the management of a user's public identity and privacy settings within the CitadelQuest platform, accessible via the `/settings/profile` route. Users have granular control over their public profile page, located at `/{username}`, with the ability to enable or disable it entirely. Customization options include uploading or removing a profile photo, writing a bio with Markdown and HTML support, and selecting specific languages and visual themes. Users can further personalize their page by uploading custom background images and applying dark overlays to improve text readability.

A significant portion of the settings is dedicated to visibility and content sharing. Users can choose to show or hide their photo, specific profile content groups, and lists of shared items. The "Spirit showcase" feature is a key component, offering three distinct modes—Off, Primary Spirit only, or All Spirits—to control the display of AI companions on both the public profile and to established CQ Contacts. This system ensures that users can precisely manage how much of their digital presence and AI interactions are visible to the public versus their direct network.


id: 2cf0a089-6493-4193-8d41-9eb203f50c24
summary: Section: Profile Content and Share Groups
category: knowledge
created_at: 2026-03-22 12:53:15
source_type: document
source_ref: general:/CQ-User-Manual:10-settings.md
source_range: 84:96
content:
Document: Profile Content and Share Groups

This document outlines the "Profile Content" and "Share Groups" features accessible via the /settings/share-groups route. It explains how users can organize their shared items into specific content groups that function as tabbed navigation on both their public profile and the CQ Explorer. Users have the ability to create these groups with customized titles, icons, colors, and visibility settings. Furthermore, the system allows users to add specific shares to these groups, reorder them, and override display styles for individual items within a group. The primary purpose of these tools is to structure how shared content is presented to others within the CitadelQuest ecosystem.


id: eec8f8e8-50b3-412d-9eaf-0ff566204624
summary: Section: CQ Feed Management
category: knowledge
created_at: 2026-03-22 12:53:25
source_type: document
source_ref: general:/CQ-User-Manual:10-settings.md
source_range: 97:125
content:
Document: CQ Feed Management

The CQ Feed Management document outlines the administrative controls for managing personal and external content streams within the CitadelQuest platform. It details two primary sections located in the user settings: My Feeds and Subscribed Feeds.

Under "My Feeds," users can manage their own publishing channels. This includes creating new feeds with specific titles, URL slugs, and descriptions, as well as setting the visibility scope to either Public or CQ Contacts. Users have the authority to edit, delete, or temporarily toggle feeds between active and inactive states. A "General" feed is automatically provided to every new user by default.

The "Subscribed Feeds" section allows users to manage content coming from other Citadels. Subscriptions are typically established automatically upon accepting friend requests or following profiles. From this interface, users can pause or resume specific feeds, unsubscribe entirely, or use the "Sync Subscriptions" feature to discover new feeds from recently added contacts. These tools ensure users have full control over both the content they broadcast to the federation and the information they receive from their network.


id: 46be8f4b-7595-4c41-97bd-a9fc496ed86d
summary: Section: Settings Navigation
category: knowledge
created_at: 2026-03-22 12:53:42
source_type: document
source_ref: general:/CQ-User-Manual:10-settings.md
source_range: 126:135
content:
Document: Settings Navigation

The Settings Navigation document outlines the primary categories available within the CitadelQuest settings sidebar. It serves as a directory for user configuration, organized into six key areas. General Settings handles core system functions such as login credentials, visual themes, database management, and data migration. The CQ Profile and Profile Content sections allow users to manage their public presence, including contact visibility and the organization of shared content groups. 

For information distribution, the My Feeds and Subscribed Feeds sections provide tools to manage personal CQ Feed channels and subscriptions to external Citadels. Finally, the AI Services section facilitates the management of AI models, the CQ AI Gateway, and user credits. This navigation structure is designed to give users centralized control over their privacy, system performance, social connectivity, and AI integration within the platform.


id: 286afe7a-b3ea-4939-9d7a-18ce2bea1353
summary: Section: Introduction
category: knowledge
created_at: 2026-03-22 12:54:09
source_type: document
source_ref: general:/CQ-User-Manual:10-settings.md
source_range: 1:8
content:
Document: Introduction

The Introduction document outlines the functionality of the Settings page within the CitadelQuest platform, accessible via the "/settings" route. This section serves as the central hub for user configuration, allowing individuals to manage their login credentials and customize their experience. Key features include the ability to select specific AI models for platform interactions and tools for account migration. The document establishes the Settings page as a critical component for personalizing the CitadelQuest environment and maintaining account security and portability.


id: bedece77-fe31-4c8b-b218-481e915a6018
summary: Section: General Settings & UI
category: knowledge
created_at: 2026-03-22 12:54:20
source_type: document
source_ref: general:/CQ-User-Manual:10-settings.md
source_range: 9:19
content:
Document: General Settings & UI

The General Settings & UI document outlines the core user configuration options within the CitadelQuest platform. The "Login Information" section details how users can manage their credentials, noting that while usernames are read-only, both email addresses and passwords can be updated through dedicated modal dialogs. Password changes specifically require the user to provide their current password for security. The "Theme" section describes the platform's visual identity, which features a dark cyber-themed aesthetic accented by a specific green color (#95ec86). Users have the ability to customize their experience by switching between various visual background themes to suit their preferences.


id: 38b43a71-1947-4515-a83c-74ef252cc74e
summary: Section: Database Management
category: knowledge
created_at: 2026-03-22 12:54:32
source_type: document
source_ref: general:/CQ-User-Manual:10-settings.md
source_range: 20:23
content:
Document: Database Management

The document, titled "Database Management," outlines two primary features for managing a user's personal SQLite database. The first feature, Database Size, allows users to monitor the current file size of their personal database. The second feature, Optimize Database, utilizes the SQLite VACUUM command to reclaim unused storage space and enhance overall system performance. These tools are designed to provide users with direct oversight and maintenance capabilities for their individual data storage within the platform.


id: 1797f8cb-c1a4-468a-8b74-3fa36968c00b
summary: Section: Account Migration
category: knowledge
created_at: 2026-03-22 12:54:42
source_type: document
source_ref: general:/CQ-User-Manual:10-settings.md
source_range: 24:38
content:
Document: Account Migration

The Account Migration document outlines the process for transferring a user's entire CitadelQuest account to a different instance. To initiate a migration, the user must select a destination server from their CQ Contacts where they have administrative privileges. The process requires either selecting an existing backup or generating a new one, followed by password confirmation. A successful migration transfers the user's complete database, files, and settings to the new location.

The system automatically notifies the user's contacts of the new address to ensure continuity. However, users should be aware that their account on the original server will be disabled once the migration is complete. For accounts containing large amounts of data, specifically those exceeding several hundred megabytes, the document recommends manually creating a backup prior to starting the migration to ensure maximum reliability during the transfer.


id: ab535c88-0269-44cd-8f4d-b01435d4710e
summary: Document: 14-cq-feed.md
category: knowledge
created_at: 2026-03-22 12:55:24
source_type: document_summary
source_ref: general:/CQ-User-Manual:14-cq-feed.md
source_range: 1:217
content:
Document: 14-cq-feed.md

CQ Feed is CitadelQuest’s decentralized social networking platform, designed to provide a familiar social media experience while maintaining data sovereignty and privacy. Unlike traditional platforms, all content is stored on the user's personal server and distributed peer-to-peer via a federation protocol. This architecture ensures there is no central server, and users retain full ownership of their data.

The service is accessible via the CQ Feed tab in CQ Explorer. It features a chronological timeline that aggregates posts from the user and their subscribed feeds. Posts support Markdown formatting for rich text and are organized into "Feeds" with specific visibility scopes: "Public" (accessible to anyone) or "CQ Contacts" (restricted to authenticated friends). Users can manage multiple feeds, allowing for different audiences and content types.

Interaction is facilitated through reactions (likes and dislikes) and a nested commenting system. These interactions are federated, meaning reactions and comments on remote posts are sent directly to the source Citadel. Content creators maintain control through moderation tools, such as the ability to hide comments on their posts.

The system includes real-time updates via background polling, notifying users of new content through visual badges and sidebar indicators. Subscriptions are managed automatically when following other profiles, though users can manually pause, resume, or unsubscribe from specific feeds. Ultimately, CQ Feed leverages HTTPS-based federation to ensure that content flows directly between Citadels, preserving privacy and enabling a truly decentralized social experience.


id: 0a97200e-a575-499b-9ffe-a9b30837050d
summary: Section: Introduction and Overview
category: knowledge
created_at: 2026-03-22 12:55:38
source_type: document
source_ref: general:/CQ-User-Manual:14-cq-feed.md
source_range: 1:21
content:
Document: Introduction and Overview

CQ Feed is CitadelQuest's decentralized social networking platform, designed to provide a familiar social media experience while maintaining user privacy and data sovereignty. Accessible via the CQ Explorer tab, the service allows users to publish posts, follow feeds from other Citadels, and engage through reactions and comments. 

The core architecture is built on a peer-to-peer federation protocol, ensuring that all content remains on the user's personal server rather than a centralized corporate platform. Key features include Markdown support for rich text formatting, real-time updates through background polling, and the ability to organize content into multiple feeds with varying visibility scopes. By distributing content across the federation, followers on other Citadels receive updates automatically, fostering cross-citadel interaction without sacrificing the decentralized nature of the ecosystem. This system enables a robust social environment where users retain full control over their data and digital presence.


id: e93c44fb-3e1d-4de2-aa28-1db1b899e648
summary: Section: Access and Timeline
category: knowledge
created_at: 2026-03-22 12:56:02
source_type: document
source_ref: general:/CQ-User-Manual:14-cq-feed.md
source_range: 22:54
content:
Document: Access and Timeline

The document "Access and Timeline" outlines the functionality and interface of the CQ Feed within the CitadelQuest ecosystem. The CQ Feed is located as a tab inside the CQ Explorer (/cq-contacts) alongside profile and contact management tools. The system is designed to remember the user's active tab preference between sessions.

The timeline provides a chronological aggregation of posts from the user and their subscriptions. Each post entry includes the author's profile information (photo, username, and domain), a feed badge indicating the visibility scope (green for CQ Contacts or gray for Public), a timestamp, and Markdown-rendered content. Users can interact with posts through reaction counts for likes and dislikes, as well as an expandable comment thread. To assist with navigation, new posts published since the user's last visit are visually distinguished by an orange left border. Content is loaded in batches, requiring users to click a "Load more" button at the bottom of the feed to access older entries.


id: 07485303-d8fc-4684-be1f-96472d0d3fdc
summary: Section: Creating and Managing Feeds
category: knowledge
created_at: 2026-03-22 12:56:33
source_type: document
source_ref: general:/CQ-User-Manual:14-cq-feed.md
source_range: 55:106
content:
Document: Creating and Managing Feeds

The document "Creating and Managing Feeds" provides a comprehensive guide on how to use and configure the social feed system within CitadelQuest. To create a post, users enter text into the "What's on your mind?" area, select a target feed, and click publish. Posts support full Markdown formatting and are distributed via federation.

Users can maintain multiple feeds with different visibility levels, known as scopes. By default, every user starts with a "Public" feed accessible to anyone without authentication. Alternatively, feeds can be set to "CQ Contacts" scope, restricting visibility to accepted contacts authenticated via API keys.

Feed management is handled through the settings menu (Settings → My Feeds), where users can create, edit, toggle, or delete feeds. When creating or editing a feed, users can customize the title, URL slug, scope, description, and cover image. Each feed is hosted on a dedicated public page using a specific URL structure based on the user's domain and username. These pages display paginated posts and adhere to the defined scope settings to ensure data privacy and proper access control.


id: db5c0c80-42c0-4b5d-bc8a-5c1b0bb50119
summary: Section: Interactions: Reactions and Comments
category: knowledge
created_at: 2026-03-22 12:56:59
source_type: document
source_ref: general:/CQ-User-Manual:14-cq-feed.md
source_range: 107:165
content:
Document: Interactions: Reactions and Comments

The document "Interactions: Reactions and Comments" outlines the functional mechanics of user engagement within the CitadelQuest platform. It details two primary interaction methods: reactions and comments. Users can react to posts using "Like" or "Dislike" icons, though they cannot react to their own content. The system allows only one reaction per post, utilizing an optimistic UI for instant updates and federation protocols to sync reactions with remote Citadels. Additionally, the platform automatically refreshes interaction stats and removes deleted posts from the cached timeline.

The commenting system features lazy-loading from source Citadels and supports nested replies up to two levels deep. Users can write comments by expanding the comment panel, with the ability to edit or delete their own contributions. For post authors, moderation tools include the ability to hide or show specific comments to manage visibility for other readers. The system also integrates a notification feature that alerts users when their posts receive comments, providing direct navigation to the relevant thread. All interactions are designed to maintain data integrity across the decentralized network while providing a responsive user experience.


id: 817c8e99-800f-40b1-a146-eb5cdfd79d0f
summary: Section: Subscriptions and Real-time Updates
category: knowledge
created_at: 2026-03-22 12:57:30
source_type: document
source_ref: general:/CQ-User-Manual:14-cq-feed.md
source_range: 166:204
content:
Document: Subscriptions and Real-time Updates

This document outlines the mechanics of subscriptions and real-time updates within the CitadelQuest ecosystem. Users automatically subscribe to feeds when they follow a profile or accept a friend request, allowing content to appear in their timeline. Subscription management is handled via the settings menu, where users can pause, resume, or permanently unsubscribe from specific feeds, as well as synchronize subscriptions to discover new content from existing contacts.

The interface utilizes a system of feed badges to denote content accessibility: green badges indicate a CQ Contacts scope, while gray badges represent public scope. These badges are visible in the CQ Explorer and on public profile pages, offering quick actions and links to public feed pages.

To ensure users stay informed, the platform employs global update polling for real-time notifications. New post detection is signaled through various UI elements, including a bell icon on the CQ Feed tab, sidebar indicators for specific contacts, and badges on the Dashboard’s CQ Explorer tile. When the CQ Feed tab is active or selected, the system automatically refreshes to fetch and display the latest posts, ensuring a seamless flow of information.


id: 5f161884-7b5c-4f24-8d9d-7503d2d3f770
summary: Section: Federation Architecture
category: knowledge
created_at: 2026-03-22 12:57:53
source_type: document
source_ref: general:/CQ-User-Manual:14-cq-feed.md
source_range: 205:217
content:
Document: Federation Architecture

The Federation Architecture document outlines the decentralized protocol used by CQ Feed to manage content across the CitadelQuest network. The system is built on the principle of data sovereignty, where posts remain on the user's personal server rather than a central authority. Communication occurs directly between Citadels over HTTPS, eliminating the need for a central server.

The federation process relies on incremental synchronization, where subscribers periodically fetch only new content from other Citadels to ensure bandwidth efficiency. Interactions such as reactions and comments are transmitted back to the source Citadel. Access is managed through scope-based permissions, distinguishing between public feeds and those requiring CQ Contacts authentication.

Privacy is a core component of this architecture. Content is stored on the creator's Citadel and only cached locally by subscribers. Users maintain full control over their data; when a post is deleted by the owner, it is automatically removed from the caches of all subscribing Citadels during the subsequent statistics refresh. This ensures that the user remains the ultimate authority over their digital footprint within the decentralized ecosystem.


id: f23cb0bb-a933-4755-b86e-774473f99e5d
summary: Document: 02-dashboard.md
category: knowledge
created_at: 2026-03-22 13:03:13
source_type: document_summary
source_ref: general:/CQ-User-Manual:02-dashboard.md
source_range: 1:76
content:
Document: 02-dashboard.md

The Dashboard serves as the central hub and home screen for the CitadelQuest platform, accessible upon login or by clicking the site logo. It is organized into several functional areas designed to provide quick access to core features and system information.

The primary interface consists of "Quick Actions" cards that direct users to essential modules, including Spirits management, CQ Explorer for contacts, CQ Profile customization, CQ Memory for knowledge graphs, the File Browser, CQ Share, Settings, and Backup tools. Users with administrative privileges also see an Admin Panel card. Visual badges on the CQ Explorer card alert users to pending friend requests, new content from followed profiles, or updates in the CQ Feed.

Below these actions, the CQ AI Gateway panel displays the user's current credit balance with color-coded status indicators and provides direct links to the AI Gateway dashboard and credit purchase page. The right sidebar monitors storage usage, breaking down data consumption across the personal SQLite database, user files, and backups.

The interface is rounded out by server information at the bottom right and a persistent top navigation bar. This bar includes a Spirit dropdown for quick chat access, a user menu for profile and system settings, a CQ Chat dropdown for recent messages, a notification center, and a language switcher supporting English, Czech, and Slovak.


id: d248e654-cce2-47f5-8cfa-df823256886a
summary: Section: Introduction and Quick Actions
category: knowledge
created_at: 2026-03-22 13:03:28
source_type: document
source_ref: general:/CQ-User-Manual:02-dashboard.md
source_range: 1:27
content:
Document: Introduction and Quick Actions

The Dashboard serves as the central hub and home screen for the CitadelQuest platform, accessible immediately upon login or by clicking the site logo. It is designed to provide streamlined navigation through a series of "Quick Action" cards that direct users to the platform's core features.

Standard users have access to eight primary cards: Spirits for managing AI companions, CQ Explorer for managing contacts and profiles, CQ Profile for public customization, CQ Memory for knowledge graph management, File Browser for data storage, CQ Share for distributing files and Memory Packs, Settings for system configuration, and Backup for data security. Users with Admin privileges see a ninth card for the Administration Panel.

The interface includes a notification system via the CQ Explorer card, which uses color-coded badges to alert users to specific activity. A red badge indicates pending friend requests, a yellow badge signifies new content from followed profiles, and a feed badge denotes new posts within the CQ Feed timeline. Each card functions as a direct shortcut to its respective route within the application, ensuring efficient access to all essential tools and social features.


id: 6768d38a-6b16-4b48-8a7c-928e5b540f1a
summary: Section: AI Gateway and System Metrics
category: knowledge
created_at: 2026-03-22 13:03:42
source_type: document
source_ref: general:/CQ-User-Manual:02-dashboard.md
source_range: 28:55
content:
Document: AI Gateway and System Metrics

The document outlines the key components of the CitadelQuest dashboard, specifically focusing on the CQ AI Gateway, storage metrics, and server information. The CQ AI Gateway panel allows users to monitor their AI credit balance via a color-coded system and provides quick access to the external dashboard and credit purchase page. The storage section provides a detailed breakdown of data usage, including the size of the user's personal SQLite database, files within the File Browser, and stored backups. Finally, the server info section displays technical details such as the Citadel's domain hostname and the current CitadelQuest version number. This interface ensures users can manage their AI resources, monitor data consumption, and verify their system status from a centralized location.


id: e281d271-dee1-402f-bfa9-c451d956c96f
summary: Section: Top Navigation Bar
category: knowledge
created_at: 2026-03-22 13:03:57
source_type: document
source_ref: general:/CQ-User-Manual:02-dashboard.md
source_range: 56:76
content:
Document: Top Navigation Bar

The Top Navigation Bar document outlines the persistent interface elements available to users within the CitadelQuest platform. This bar serves as the primary navigation hub, featuring the CitadelQuest Logo for quick access back to the Dashboard. It includes a Spirit Icon dropdown that allows users to launch the Spirit Chat modal or visit specific Spirit profile pages.

The User Menu, identified by the individual's username, provides links to core platform features such as CQ Explorer, CQ Profile, CQ Memory, the File Browser, and system Settings, as well as Admin tools and Logout options. Additionally, the bar facilitates communication through the CQ Chat dropdown, which displays recent conversations and message counts, and a Notifications bell for unread alerts. Finally, the interface includes a Language switcher supporting English, Czech, and Slovak, ensuring the platform remains accessible across different locales.


id: 5c1d4226-1487-425c-a876-1d9a57c6e058
summary: Document: 07-cq-contacts.md
category: knowledge
created_at: 2026-03-22 13:05:14
source_type: document_summary
source_ref: general:/CQ-User-Manual:07-cq-contacts.md
source_range: 1:194
content:
Document: 07-cq-contacts.md

The document "07-cq-contacts.md" details the CQ Explorer, a unified hub within the CitadelQuest platform for managing social interactions, profiles, and contacts. Located at the `/cq-contacts` route, the interface uses a two-column layout featuring a main panel for profile browsing and social feeds, and a sidebar for managing contact lists.

The system distinguishes between two types of social connections:
- **CQ Follow:** A one-way, lightweight subscription that allows users to receive updates and notifications about new content from public profiles without requiring mutual approval.
- **CQ Contacts:** A mutual, secure "friend" system. Establishing a contact involves a friend request and the exchange of unique CQ Contact API keys. This creates a secure HTTPS communication channel for private messaging via CQ Chat and access to shared files or Memory Packs.

Key features of the Explorer include the ability to view profile photos, bios, and "Spirit showcases" (AI assistants), as well as downloading shared items directly to a user's Citadel. The sidebar organizes Contacts, Following, and Followers into collapsible sections with visual indicators for new content.

The underlying architecture is based on a decentralized federation protocol. There is no central directory; instead, Citadels communicate directly via HTTPS. This ensures data privacy and sovereignty, as no third party can access messages or contact lists. The system also supports account migration, automatically notifying contacts and followers if a user moves to a different Citadel domain.


id: 65f0c8c9-5667-4326-983b-ea28d6224bd1
summary: Section: Introduction and Layout
category: knowledge
created_at: 2026-03-22 13:05:24
source_type: document
source_ref: general:/CQ-User-Manual:07-cq-contacts.md
source_range: 1:22
content:
Document: Introduction and Layout

CQ Explorer is a unified hub within the CitadelQuest platform designed for managing social interactions, profiles, and content discovery. Accessible via the `/cq-contacts` route, it serves as a central interface for users to explore CQ Profiles, manage contacts, and follow other users across different Citadels. The system integrates profile browsing and contact management with a social feed to facilitate seamless interaction.

The interface utilizes a two-column layout featuring a 75% Main Panel and a 25% Sidebar. The Main Panel contains two primary tabs: "CQ Explorer," which includes a URL input for profile browsing and previews, and "CQ Feed," which houses a social timeline and post composer. The Sidebar is dedicated to managing lists of CQ Contacts, Following, and Followers. The application is designed to remember the user's active tab between sessions, ensuring a consistent experience across visits.


id: a0d54d94-2d3c-4764-94e4-8c05548f866c
summary: Section: Exploring Profiles
category: knowledge
created_at: 2026-03-22 13:05:38
source_type: document
source_ref: general:/CQ-User-Manual:07-cq-contacts.md
source_range: 23:50
content:
Document: Exploring Profiles

The document "Exploring Profiles" provides a technical and functional overview of how users interact with others on the CitadelQuest platform. To explore a profile, a user enters a specific CitadelQuest URL into the input field and selects the "Explore" option. The system then fetches and displays a comprehensive set of data, including the user's profile photo, username, domain link, and a biography. Notably, the interface showcases the user's AI Spirits, detailing their names, levels, experience points (XP), and associated colors. It also displays follower counts and organized content groups.

Beyond viewing information, the Explorer tool enables several interactive capabilities. Users can send direct friend requests via the "Add Contact" button, follow or unfollow profiles for content updates, and interact with shared media. This includes downloading files and CQ Memory Packs directly to their own Citadel, adding Memory Packs to personal libraries, and viewing inline previews of Memory Pack graphs. For convenience, the Explorer utilizes localStorage to remember and auto-load the most recently viewed profile upon the user's next visit. The document highlights the platform's focus on decentralized sharing and the integration of AI Spirits within the social ecosystem.


id: 801a2309-1b49-4fea-9b0e-63811bfd49c9
summary: Section: Sidebar Management
category: knowledge
created_at: 2026-03-22 13:05:48
source_type: document
source_ref: general:/CQ-User-Manual:07-cq-contacts.md
source_range: 51:86
content:
Document: Sidebar Management

The Sidebar Management document details the functionality of the right sidebar within the CitadelQuest interface, which organizes user connections into three distinct, collapsible glass-panel sections. These sections include CQ Contacts (friend connections from other Citadels), Following (subscribed profiles), and Followers (users following the account). Each entry across these lists displays the individual's profile photo, username, and domain.

The sidebar utilizes a color-coded badge system to indicate totals: green for contacts, yellow for following, and blue for followers. Specific visual cues are used for the Following section to denote activity, such as yellow highlights and dot badges for profiles with new content or unseen updates. 

Key technical features include SPA-like navigation, allowing users to load profiles into the main panel instantly without a page reload. The sidebar also supports persistent UI states by saving the collapsed or expanded status of sections to localStorage. Additionally, the interface provides active item highlighting with a cyber-colored border accent to indicate the currently viewed profile and includes feed update indicators to notify users of new posts from those they follow.


id: 053514be-6c8d-4eb4-bbe0-26e16618e0f6
summary: Section: CQ Follow System
category: knowledge
created_at: 2026-03-22 13:06:07
source_type: document
source_ref: general:/CQ-User-Manual:07-cq-contacts.md
source_range: 87:122
content:
Document: CQ Follow System

CQ Follow is a lightweight, one-way subscription system within the CitadelQuest platform that allows users to stay informed about public profiles without requiring a mutual friend relationship. By following a profile through the CQ Explorer, users can track updates which are then displayed in a dedicated "Following" sidebar. The system utilizes the federation protocol to facilitate cross-Citadel communication, ensuring that the followed user is notified and their public follower count is updated accordingly.

The system features an automated notification framework to highlight new content. When a followed profile publishes updates, the platform alerts the user via yellow background highlights and dot badges in the sidebar, yellow borders on new Explorer content, and a notification badge on the Dashboard’s CQ Explorer tile. Additionally, a bell icon appears on the CQ Feed tab to signal new posts. Following a profile also results in an automatic subscription to that user's feeds. This functionality remains entirely separate from the CQ Contacts system, providing a streamlined way to monitor public activity while maintaining the decentralized nature of the platform.


id: 5f6ed2d1-f034-4fe2-9616-f780394b8eee
summary: Section: CQ Contacts (Friend System)
category: knowledge
created_at: 2026-03-22 13:06:32
source_type: document
source_ref: general:/CQ-User-Manual:07-cq-contacts.md
source_range: 123:158
content:
Document: CQ Contacts (Friend System)

CQ Contacts is the mutual friend system within the CitadelQuest platform that enables secure connections between users across different Citadels. A user's identity is uniquely defined by their domain ownership and username, such as "https://one.citadelquest.world/Human." Unlike the one-way "Follow" system, CQ Contacts requires a mutual agreement to establish a relationship.

The process begins in the CQ Explorer, where a user can send a friend request to another profile. Recipients are notified via a bell icon and a red badge on their Dashboard's CQ Explorer card, where they can choose to accept or reject the request. Upon acceptance, the system automatically exchanges CQ Contact API keys between the two Citadels to establish a secure HTTPS communication channel. This connection enables several features: users can engage in direct messaging via CQ Chat, they appear in each other's sidebar contact lists, and they are automatically subscribed to each other's CQ Feeds, ensuring their posts appear in the respective timelines. This system forms the foundation for secure, decentralized social interaction and data exchange within the ecosystem.


id: 9dff485b-1e98-421d-9651-00cf55e1c512
summary: Section: Contact Interaction and Downloads
category: knowledge
created_at: 2026-03-22 13:07:20
source_type: document
source_ref: general:/CQ-User-Manual:07-cq-contacts.md
source_range: 159:178
content:
Document: Contact Interaction and Downloads

The "Contact Interaction and Downloads" document outlines how users interact with profiles and shared content within the CitadelQuest ecosystem. When selecting a contact from the sidebar, the Detail Page displays information based on the user's visibility settings, which may include their profile photo, username, domain link, bio, and a "Spirit showcase" featuring their AI Spirits' names, levels, and experience points.

The document also details the process for downloading shared items directly to a user's Citadel. Shared files are saved to the File Browser's downloads folder, while Memory Packs (.cqmpack) are stored in a dedicated contact library within the Memory Explorer. Notably, Memory Packs feature automatic synchronization, ensuring that any updates made by the original contact are reflected in the user's local copy. For further information on managing these permissions, the document refers users to the CQ Share documentation.


id: 6f03b33e-d631-48c5-a85f-b0cb00b6ca37
summary: Section: Federation Protocol
category: knowledge
created_at: 2026-03-22 13:07:32
source_type: document
source_ref: general:/CQ-User-Manual:07-cq-contacts.md
source_range: 179:194
content:
Document: Federation Protocol

The Federation Protocol document outlines the decentralized communication framework of CitadelQuest, emphasizing a system built on privacy and direct interaction. The protocol operates without a central directory, requiring users to connect directly with known individuals. Security is maintained through CQ Contact API Keys, which are unique to each friendship and exchanged during the friend request process to facilitate secure HTTPS communication between Citadels. This architecture ensures that no third party can access contact lists or private messages.

Key features of the protocol include the exchange of rich profiles—such as photos, bios, and Spirits—governed by individual visibility settings. It also supports content sharing of files and Memory Packs via CQ Share, as well as a social feed system for posts and reactions through CQ Feed. The protocol handles follow notifications with built-in fraud prevention through origin and host validation. Additionally, the system supports seamless account migration; if a user moves to a different Citadel, the federation protocol automatically notifies and updates their contacts and followers with the new address.


id: ed80ee81-892a-4356-9a1b-c30f5200cb02
summary: Document: 00-introduction.md
category: knowledge
created_at: 2026-03-22 13:08:17
source_type: document_summary
source_ref: general:/CQ-User-Manual:00-introduction.md
source_range: 1:91
content:
Document: 00-introduction.md

CitadelQuest is a free, open-source, and self-hosted platform designed to prioritize personal data sovereignty and human-AI collaboration. Described as a "digital fortress," the platform allows users to maintain full control over their information by utilizing a decentralized architecture where each user has an isolated SQLite database. Core principles include a "privacy first" approach with no tracking or ads, complete transparency through auditable code, and the use of AI "Spirits" as partners rather than corporate tools.

The document outlines a robust feature set, including AI Spirits with memory and tools, 3D knowledge graphs (CQ Memory), personal cloud storage, encrypted private messaging (CQ Chat), and a decentralized social feed (CQ Feed). Users can also manage public profiles, follow others across different Citadels, and share files or knowledge packs.

For deployment, the manual provides two primary paths: an immediate online registration at one.citadelquest.world or a self-hosted installation via a PHP-based installer. Technical requirements for self-hosting include PHP 8.4+, Apache with mod_rewrite, and the SQLite3 extension. The project is maintained by an anonymous team of humans and AI, licensed under the GNU Affero General Public License, and supports English, Czech, and Slovak languages.


id: fcedcace-094a-43e8-ab50-4b8bfcc6b552
summary: Section: Introduction and Core Principles
category: knowledge
created_at: 2026-03-22 13:08:33
source_type: document
source_ref: general:/CQ-User-Manual:00-introduction.md
source_range: 1:21
content:
Document: Introduction and Core Principles

CitadelQuest is a free, open-source, and self-hosted platform designed to facilitate personal data sovereignty and AI-human collaboration. Functioning as a personal digital "Citadel," the platform allows users to maintain full control over their digital lives by bypassing traditional Big Tech infrastructure. Key features include personal data storage on the user's own server, direct and encrypted communication, a personal cloud for file management, and the organization of knowledge through interactive 3D graphs.

The document outlines several core principles that define the platform's architecture. It prioritizes privacy by ensuring no ads, tracking, or data collection occur, making data exploitation technologically impossible. The system is fully decentralized, meaning every installation is independent of a central authority. Transparency is maintained through an open-source model that allows for public auditing of the code. Furthermore, security is enhanced by a "one database per user" structure, which isolates personal information into individual database files. Finally, the platform emphasizes human-AI collaboration, positioning AI "Spirits" as partners rather than mere corporate tools. This manual serves as an introduction to how CitadelQuest empowers users to manage their data and AI interactions within a secure, private, and transparent environment.


id: 29feed29-6c8f-483b-9b9a-a119a7ee7755
summary: Section: Feature Overview
category: knowledge
created_at: 2026-03-22 13:08:42
source_type: document
source_ref: general:/CQ-User-Manual:00-introduction.md
source_range: 22:39
content:
Document: Feature Overview

The "Feature Overview" document outlines the core functionalities of the CitadelQuest platform, highlighting its focus on AI companionship, decentralized communication, and data management. Central to the experience are "Spirits," which are personal AI companions equipped with memory and specialized tools. Data organization is handled through "CQ Memory" for knowledge graphs and a "File Browser" for personal cloud storage.

The platform emphasizes social connectivity and federation through "CQ Chat" for private messaging, "CQ Explorer" for contact management, and "CQ Follow" for profile subscriptions. Users can engage with a decentralized social ecosystem via "CQ Feed," which supports posting and reacting across different Citadels. Additionally, "CQ Share" allows for the distribution of files and Memory Packs, while "CQ Profile" offers a customizable public presence. Security and accessibility are addressed through full data backup and restore capabilities, with the interface supporting English, Czech, and Slovak languages.


id: b2baf1a4-1547-4c2f-bc0c-31a1ca228a58
summary: Section: Quick Start Guide
category: knowledge
created_at: 2026-03-22 13:08:55
source_type: document
source_ref: general:/CQ-User-Manual:00-introduction.md
source_range: 40:59
content:
Document: Quick Start Guide

The Quick Start Guide for CitadelQuest outlines two primary methods for users to begin using the platform. The first and fastest method, Option A, involves visiting the official website at one.citadelquest.world, where users can register an account, complete an onboarding wizard to configure their first AI Spirit, and begin chatting immediately. 

The second method, Option B, allows users to host their own private Citadel. This process requires downloading an 8 KB installer package from GitHub Releases and uploading the install.php file to a personal web server. The installer automates the setup process, and the first account registered on the self-hosted instance is automatically granted administrative privileges. To successfully install a private Citadel, the server must meet specific technical requirements, including PHP 8.4 or higher, Apache with mod_rewrite enabled, and the SQLite3 extension. Both options are designed to facilitate a quick transition into the CitadelQuest ecosystem, whether through a hosted service or a decentralized, self-managed deployment.


id: 3aac084f-8acc-4ab5-bdb6-c866da238217
summary: Section: Manual Organization
category: knowledge
created_at: 2026-03-22 13:09:16
source_type: document
source_ref: general:/CQ-User-Manual:00-introduction.md
source_range: 60:80
content:
Document: Manual Organization

This document outlines the organizational structure of the CitadelQuest manual, detailing fourteen distinct chapters that guide users through the platform's features and technical setup. The manual begins with foundational steps, covering registration, onboarding, and navigation via the Dashboard. It then delves into core functionalities, including the management of AI companions known as Spirits, the use of knowledge graphs in CQ Memory, and personal cloud file management through the File Browser.

Communication and social features are categorized into private messaging (CQ Chat), contact management (CQ Explorer), and the social feed (CQ Feed). Users are also provided with instructions on sharing data, managing their public identity via CQ Profile, and adjusting system preferences in the Settings. For more technical or administrative needs, the manual includes dedicated sections on data backup and restoration, the administration panel for Citadel managers, and comprehensive instructions for self-hosting the platform through the Installation chapter. Overall, the document serves as a roadmap for understanding both the user-facing tools and the underlying decentralized infrastructure of the CitadelQuest ecosystem.


id: b6059177-ac86-4ec5-8e30-b075531ab4fb
summary: Section: About and Project Links
category: knowledge
created_at: 2026-03-22 13:09:26
source_type: document
source_ref: general:/CQ-User-Manual:00-introduction.md
source_range: 81:91
content:
Document: About and Project Links

CitadelQuest is an open-source project developed through a collaborative effort between humans and AI. The project emphasizes its community and mission over individual recognition, as the authors have chosen to keep their personal identities private. The platform is released under the GNU Affero General Public License, ensuring it remains free and accessible to the public indefinitely. Key resources for the project include its official website at www.citadelquest.com and its source code repository on GitHub. Users can engage with the project via its X account, "Human from CitadelQuest," or reach out for inquiries through the provided contact email at info@citadelquest.email. This document serves as a central directory for the project's philosophy, licensing information, and essential digital links.


id: 388726da-f2bc-4e76-a6fe-84513b160a93
summary: Document: CITADELQUEST.md
category: knowledge
created_at: 2026-03-22 13:14:12
source_type: document_summary
source_ref: general:/CQ-User-Manual:CITADELQUEST.md
source_range: 1:108
content:
Document: CITADELQUEST.md

CitadelQuest is a free, open-source, and self-hosted platform designed to provide personal data sovereignty and facilitate human-AI collaboration. Described as a "digital fortress," the system utilizes a fully decentralized architecture where each user maintains their own independent SQLite database on their own server, making data exploitation by third parties technologically impossible. The platform replaces traditional social media models with a peer-to-peer federation protocol, allowing for encrypted communication and content sharing without central corporate servers.

Key features include "AI Spirits," which are customizable personal assistants capable of managing files and building 3D knowledge graphs (CQ Memory) to serve as persistent memory. The ecosystem also provides a decentralized social network (CQ Feed and CQ Profile), a personal cloud (File Browser), and encrypted messaging (CQ Chat). Built on a stack of PHP 8.4, Symfony, and SQLite, the platform is designed for easy deployment via an 8 KB zero-click installer and supports multiple languages.

The project’s vision centers on the belief that data belongs to the user, offering an ad-free, algorithm-free alternative to "Big Tech." While the software is free, development is supported through the CQ AI Gateway, a pay-per-use service that grants Spirits access to advanced LLMs like Claude, Gemini, and Grok. Users can join existing instances or host their own to ensure complete control over their digital lives.


id: d74db975-0e53-48c5-acf9-89341aed88e0
summary: Section: Introduction and Core Philosophy
category: knowledge
created_at: 2026-03-22 13:14:24
source_type: document
source_ref: general:/CQ-User-Manual:CITADELQUEST.md
source_range: 1:13
content:
Document: Introduction and Core Philosophy

CitadelQuest is a free, open-source, and self-hosted platform designed to provide users with complete personal data sovereignty and a secure environment for AI-human collaboration. Described as a "digital fortress" or "Citadel," the platform ensures that a user's data, digital life, and AI companions remain entirely under their own control. The core philosophy centers on the elimination of Big Tech influence, specifically prohibiting advertisements, tracking, and data collection.

Technologically, every CitadelQuest installation operates independently. Each user's personal information is stored in a private database on their own server, making it impossible for external parties to exploit the data. For social interaction, the platform utilizes a direct, encrypted federation protocol that allows users to connect with friends across different Citadels without the need for intermediary corporate servers. This architecture prioritizes privacy, security, and individual agency in the digital realm.


id: f50c6cee-cb51-430c-9946-71b6bd397a6e
summary: Section: Personal Space Features
category: knowledge
created_at: 2026-03-22 13:14:42
source_type: document
source_ref: general:/CQ-User-Manual:CITADELQUEST.md
source_range: 14:24
content:
Document: Personal Space Features

The document "Personal Space Features" details the core functionalities available within a user's private digital environment. It highlights three primary components: AI Spirits, CQ Memory, and the File Browser. AI Spirits serve as personal companions with distinct personalities and memory, capable of performing tasks like image generation and file management using various advanced AI models via the CQ AI Gateway. CQ Memory provides a sophisticated way to store and visualize information through interactive 3D knowledge graphs, which allow Spirits to maintain persistent context across different interactions and enable users to share structured knowledge with others. Finally, the File Browser acts as a personal cloud storage system where users can organize data on their own server. Spirits have the capability to read, create, and edit these files, and users can share their content either publicly or with specific contacts. Together, these features create an integrated ecosystem for personal data management and AI-human collaboration.


id: 15d5b4f0-e5e8-476d-8481-abd0ee59c1ac
summary: Section: Decentralized Social Network
category: knowledge
created_at: 2026-03-22 13:14:54
source_type: document
source_ref: general:/CQ-User-Manual:CITADELQUEST.md
source_range: 25:38
content:
Document: Decentralized Social Network

The Decentralized Social Network document outlines a suite of features designed to facilitate peer-to-peer interaction while maintaining user sovereignty. Central to this ecosystem is the CQ Profile, which serves as a public identity hosted on the user's personal domain, allowing for extensive customization of bios, themes, and content. Users can discover and manage connections through the CQ Explorer, while the CQ Feed provides a familiar social interface for publishing posts and interacting via likes and comments. Unlike traditional platforms, all feed content remains on the user's server and is distributed via federation.

Communication and sharing are handled through CQ Chat and CQ Share. CQ Chat offers private, encrypted messaging and group chats secured by API keys, ensuring data is only stored on the participants' Citadels. CQ Share allows for the organization of files and knowledge graphs into public or contact-specific groups, effectively transforming a profile into a personal website. Additionally, the CQ Follow feature enables one-way subscriptions to public profiles, providing real-time notifications of new content without the need for mutual friendship. Together, these tools create a robust, decentralized environment for social networking, content distribution, and secure communication.


id: 87a30a49-d955-4153-92a8-790da5778992
summary: Section: Infrastructure and Deployment
category: knowledge
created_at: 2026-03-22 13:15:04
source_type: document
source_ref: general:/CQ-User-Manual:CITADELQUEST.md
source_range: 39:51
content:
Document: Infrastructure and Deployment

The "Infrastructure and Deployment" document outlines the technical foundation and accessibility features of the CitadelQuest platform. Key highlights include a highly efficient "Zero-Click Installer"—an 8 KB file compatible with shared hosting, VPS, and dedicated servers—designed for rapid deployment. The infrastructure supports long-term maintenance through built-in, one-click updates that feature automatic safety backups.

Data sovereignty and portability are prioritized through comprehensive backup and restore capabilities, which include chunked uploads for large datasets and a migration system that automatically notifies contacts when a user moves between Citadels. For accessibility, the platform functions as a Progressive Web App (PWA), allowing for an app-like experience across Android, iOS, and desktop devices. Furthermore, the system is designed for a global audience, offering multi-language support for English, Spanish, Czech, Italian, Hungarian, Norwegian, Polish, and Slovak. Overall, the document describes a user-friendly, secure, and portable ecosystem for personal data management.


id: 435cb822-7d90-4d52-a3ea-f7f6ee6691e9
summary: Section: Technical Architecture
category: knowledge
created_at: 2026-03-22 13:15:21
source_type: document
source_ref: general:/CQ-User-Manual:CITADELQUEST.md
source_range: 52:71
content:
Document: Technical Architecture

The Technical Architecture document outlines the foundational principles and technology stack of the CitadelQuest platform, emphasizing a decentralized and security-first approach. The architecture is built on the principle of complete data isolation, utilizing one dedicated SQLite database per user. This decentralized model ensures that each "Citadel" operates independently without a central authority or single point of failure, facilitating direct citadel-to-citadel communication via HTTPS federation and CQ Contact API key authentication.

The platform is fully open-source and designed for self-hosting, allowing users total control over their data and server environment. The backend is powered by PHP 8.4 and Symfony 7.4 running on Apache, while the frontend utilizes modern vanilla JavaScript, Bootstrap CSS, and Three.js for 3D visualizations. While the system is designed to have no external dependencies, it offers optional AI integration through the CQ AI Gateway. This service provides access to various Large Language Models, including Claude, Gemini, and Grok, while maintaining a policy of zero data retention to preserve user privacy.


id: cd3c709f-84fd-42e3-b25d-734002a02b81
summary: Section: The Vision
category: knowledge
created_at: 2026-03-22 13:15:31
source_type: document
source_ref: general:/CQ-User-Manual:CITADELQUEST.md
source_range: 72:85
content:
Document: The Vision

The Vision outlines the foundational philosophy of CitadelQuest, a platform built on the core principle of absolute data sovereignty. It presents a direct alternative to the data-harvesting practices of major technology corporations by utilizing a decentralized architecture that makes personal data exploitation technologically impossible. The document emphasizes that CitadelQuest is more than a privacy tool; it is a space for meaningful Human-AI collaboration. Within this ecosystem, AI "Spirits" act as personal companions that manage knowledge and grow with the user, serving the individual's interests rather than a corporate entity. Furthermore, the vision describes a new paradigm for social networking that is ad-free and decentralized. In this environment, users own their content and connect directly with others without the interference of profit-driven algorithms. Ultimately, the document defines CitadelQuest as a personal "Citadel" where the user maintains total control over their data and digital rules.


id: 0a222aba-70c1-4a22-bcb3-3472084fb4ec
summary: Section: Getting Started and Support
category: knowledge
created_at: 2026-03-22 13:15:59
source_type: document
source_ref: general:/CQ-User-Manual:CITADELQUEST.md
source_range: 86:108
content:
Document: Getting Started and Support

The "Getting Started and Support" document provides essential entry points and resources for the CitadelQuest platform. Users can begin exploring the ecosystem immediately via the free public instance at one.citadelquest.world or choose to host their own private instance by downloading an 8 KB installer from the project's GitHub Releases page. The document emphasizes a "Privacy First" and "Free Forever" philosophy, noting that the project is open-source and developed through a collaboration between humans and AI.

For further information and community engagement, the document lists several official channels, including the main website (www.citadelquest.com), the GitHub repository, and an X (formerly Twitter) account (@H_CitadelQuest). Direct inquiries can be sent to info@citadelquest.email. While the software itself is free, continued development is supported through the CQ AI Gateway (cqaigateway.com), which provides fair-priced AI services to power the platform's "Spirits." The document serves as a concise roadmap for new users to register, install, or support the decentralized CitadelQuest mission.


id: dd40e138-a40c-40b3-bcea-733c8528cf98
summary: Document: 09-cq-profile.md
category: knowledge
created_at: 2026-03-22 17:17:01
source_type: document_summary
source_ref: general:/CQ-User-Manual:09-cq-profile.md
source_range: 1:182
content:
Document: 09-cq-profile.md

CQ Profile is the public identity and landing page system for the CitadelQuest platform, accessible via a user's specific Citadel URL. It serves as a customizable, ad-free personal homepage where users can showcase their identity, AI Spirit companions, and shared content. The profile displays key elements including a profile photo, a Markdown/HTML-supported bio, follower counts, and feed badges. A central feature is the Spirit showcase, which highlights the user’s AI companions, including their names, levels, and experience points (XP).

Users maintain granular control over their privacy through two primary settings tabs. The Public Profile Page tab manages visibility for the general web, allowing users to toggle the profile on or off, select from built-in themes (such as CitadelQuest cityscape or Night Forest), or upload custom background images. The CQ Contact Visibility tab specifically manages what federated contacts can see, such as bio and photo details.

Content on the profile is organized through "Profile Content" groups, which appear as tabbed navigation for shared files and items. Beyond the public web view, the profile integrates with the CQ Explorer for social discovery and CQ Chat for identity verification. Admins also have the ability to redirect the root domain of a Citadel to a specific user's public profile. If the profile is disabled, the public URL returns a 404 error, though federation data may still be visible to approved contacts.


id: e9485b3e-c6ec-4630-90b8-4a3c2ecfcae7
summary: Section: Introduction to CQ Profile
category: knowledge
created_at: 2026-03-22 17:17:13
source_type: document
source_ref: general:/CQ-User-Manual:09-cq-profile.md
source_range: 1:8
content:
Document: Introduction to CQ Profile

CQ Profile serves as the public identity and personal landing page for users within the CitadelQuest platform. Located at the user's specific username URL, this feature allows individuals to present a curated public image to visitors, showcasing their identity, their Spirits, and any content they have chosen to share. The system is designed with privacy and user agency in mind, ensuring that the owner maintains total control over what information is visible to the public. Management of the profile, including customization and visibility settings, is handled through the dedicated profile settings route. Ultimately, it functions as a professional and aesthetic gateway for others to interact with a user's Citadel while upholding the platform's core principles of data sovereignty.


id: 6d605571-2f26-49dc-b6b2-4731a876680e
summary: Section: Public Profile Page Features
category: knowledge
created_at: 2026-03-22 17:17:31
source_type: document
source_ref: general:/CQ-User-Manual:09-cq-profile.md
source_range: 9:37
content:
Document: Public Profile Page Features

The Public Profile Page in CitadelQuest serves as a customizable, ad-free digital identity hub accessible via a unique URL based on the user's domain and username. When enabled, the page showcases a variety of personal and platform-specific elements, including the user's profile photo, a bio with full Markdown and HTML support, and a follower count. It also highlights the user's AI Spirit companions, displaying their names, levels, and experience points.

Content organization is a central feature, allowing users to display shared items through tabbed content groups or an optional flat list of public CQ Share items. Visual customization is supported through background themes or custom images. Additionally, the profile includes feed badges linking to public CQ Feed pages and a footer indicating the CitadelQuest version. For those managing their own instance, a Citadel admin can configure the root URL of the domain to redirect specifically to a chosen user's public profile page, effectively turning the Citadel into a personal landing page.


id: 793a341d-107b-434d-96ec-6717d147e67c
summary: Section: Profile Settings and Visibility
category: knowledge
created_at: 2026-03-22 17:17:40
source_type: document
source_ref: general:/CQ-User-Manual:09-cq-profile.md
source_range: 38:78
content:
Document: Profile Settings and Visibility

The document "Profile Settings and Visibility" outlines the configuration options available to users at the `/settings/profile` route, accessible via the user menu or general settings. The settings are divided into two primary tabs: Public Profile Page and CQ Contact Visibility.

The Public Profile Page tab manages the external-facing version of a user's profile. Users can toggle the page on or off, manage their shareable URL, and control the visibility of their photo, shared content groups, and public items. This section also features a "Spirit showcase" with three display modes: Off, Primary Spirit only, or All Spirits. Customization options include language selection (English, Czech, or Slovak) and various visual themes such as Night Forest or Dreamy Flowers. Users may also upload a custom background image (up to 5MB) and toggle a dark overlay to improve text readability.

The CQ Contact Visibility tab governs data shared with contacts via the federation protocol. It allows users to specifically enable or disable the sharing of their bio and profile photo. Similar to the public page, it includes a three-mode control for the Spirit showcase, ensuring users can manage how their AI companions are presented to their direct contacts.


id: b9905007-e9cb-477e-9a72-87ab9d4bab49
summary: Section: Profile Photo and Bio
category: knowledge
created_at: 2026-03-22 17:17:58
source_type: document
source_ref: general:/CQ-User-Manual:09-cq-profile.md
source_range: 79:111
content:
Document: Profile Photo and Bio

This document provides instructions for managing a user's profile photo and bio within the CitadelQuest platform. Users can upload a profile photo (JPEG, PNG, WebP, or GIF up to 5MB) via the CQ Profile settings. Once uploaded, the photo is displayed on the user's public profile page, the CQ Explorer sidebar for contacts and followers, and next to messages in CQ Chat. If a photo is removed, a default avatar icon is used.

Additionally, the document details the Bio section, where users can write a personal description. The Bio field supports Markdown and HTML for rich text formatting, such as links and lists, and includes a character counter. The bio is visible on the user's public profile page, in CQ Explorer, and within the CQ Contact view when others browse the profile. Together, these features allow users to customize their digital identity and control how they are presented to others across the decentralized network.


id: ab54e914-5441-4f6f-823b-0bcc238ff9ea
summary: Section: Spirit Showcase and Profile Content
category: knowledge
created_at: 2026-03-22 17:18:19
source_type: document
source_ref: general:/CQ-User-Manual:09-cq-profile.md
source_range: 112:137
content:
Document: Spirit Showcase and Profile Content

The document outlines two primary components of the CitadelQuest user interface: the Spirit Showcase and Profile Content (Share Groups). The Spirit Showcase is a visual display of a user's AI companions, featuring a color-coded ghost icon, the Spirit's name, and their current level and experience points (XP). If a user has multiple Spirits, a star icon designates the primary one. The layout adapts to the device, appearing on the right side of the header on desktops and in a compact format below the header on mobile devices. These Spirits are visible to CQ Contacts in the CQ Explorer and on public pages, depending on privacy settings.

The Profile Content section explains how users can organize shared items into "Share Groups," which function as tabbed navigation on their public profiles. Managed via the settings route `/settings/share-groups`, these groups allow users to categorize different types of content, such as introductions, projects, or galleries. These tabs can contain various shared files and Memory Packs, providing a structured way for others to browse the user's shared information within the CitadelQuest ecosystem.


id: 51b3f29a-7dce-43c0-bf22-7a4f6ed61ae6
summary: Section: Themes and Background Customization
category: knowledge
created_at: 2026-03-22 17:18:29
source_type: document
source_ref: general:/CQ-User-Manual:09-cq-profile.md
source_range: 138:164
content:
Document: Themes and Background Customization

The document "Themes and Background Customization" outlines the visual personalization options available for a user's public profile. Users can select from five built-in themes, which include Default (matching the visitor's theme), CitadelQuest (cityscape), Night Forest, Dreamy Flowers, and a minimal Clear option. Each theme is presented via a thumbnail preview in the settings menu.

Beyond preset themes, users can upload a custom background image in JPEG, PNG, or WebP formats. Recommended specifications for these uploads include a resolution of at least 1920×1080 and a maximum file size of 5MB. A custom image will override any selected built-in theme. To ensure text remains legible against various backgrounds, the platform provides a Background Overlay toggle that adds a dark, semi-transparent layer over the image. The document notes that these customization choices specifically define the appearance of the user's public page and operate independently of a visitor's personal theme settings.


id: 3c2e49fa-9e84-4b17-9991-6770b3ad597b
summary: Section: User Interaction and Access
category: knowledge
created_at: 2026-03-22 17:18:47
source_type: document
source_ref: general:/CQ-User-Manual:09-cq-profile.md
source_range: 165:182
content:
Document: User Interaction and Access

The document outlines how a user's profile and content are accessed by different groups within the CitadelQuest ecosystem. Public visitors can view a profile page at the user's specific URL without logging in, provided the feature is enabled; otherwise, they encounter a 404 error. The language of this public page is determined by the owner's settings. Other CitadelQuest users interacting via CQ Explorer can view profile cards and shared items, as well as initiate follows or friend requests. 

For more integrated interactions, CQ Contacts utilize a secure federation protocol to access bio information, photos, and Spirits based on specific visibility settings. Followers are granted the ability to see public content and receive notifications regarding new publications. While the public web presence can be disabled, the document notes that federation profile data remains accessible to CQ Contacts according to the user's established privacy configurations. Overall, the system balances public accessibility with secure, protocol-based sharing for authenticated contacts and followers.


# memory_jobs

id: 924d9573-db7b-4d7c-9681-1b6168e6314c
type: extract_recursive
status: completed
result: {"total_memories":6,"message":"Extraction complete. Created 6 memory nodes."}
created_at: 2026-03-12 13:07:52
started_at: 2026-03-12 13:07:52
completed_at: 2026-03-12 13:10:07
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:00-introduction.md","document_title":"00-introduction.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":6,"current_depth":1,"extracted_node_ids":["2e26f50c-1b09-45cf-9dab-b75f17751543","963a7c12-af9c-47b8-a07b-ff3ffda85b5a","29bcd0c6-5415-4c56-88ac-9767ae30613f","9ca0eb2f-81e3-4399-b87b-d82554e10d3d","f6fb3dc7-a6a9-4a25-89e5-f77f2b027ed8","fa80e472-490b-4a98-8c5b-5b49636606f7"],"skip_analysis":true,"last_step_request_at":1773321007,"root_node_id":"2e26f50c-1b09-45cf-9dab-b75f17751543","base_tag":"document","current_block_title":"About and Contact Information","step_locked_at":1773321007}


id: 3477b9c8-6828-494a-9359-642a5479d414
type: extract_recursive
status: completed
result: {"total_memories":4,"message":"Extraction complete. Created 4 memory nodes."}
created_at: 2026-03-12 13:11:07
started_at: 2026-03-12 13:11:07
completed_at: 2026-03-12 13:13:39
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:01-registration-and-onboarding.md","document_title":"01-registration-and-onboarding.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":4,"current_depth":1,"extracted_node_ids":["f080d9f1-7a52-443e-b81c-9bd0c76bd111","fd441b64-9557-464b-b15c-080626d39052","624ac4e8-9af6-42b8-93fe-e514b7e7c1fc","56d69ed3-d0f5-414c-b07d-a3ad52e09863"],"skip_analysis":true,"last_step_request_at":1773321219,"root_node_id":"f080d9f1-7a52-443e-b81c-9bd0c76bd111","base_tag":"document","current_block_title":"Post-Onboarding and Language Settings","step_locked_at":1773321219}


id: 5e3ffb43-cfd5-4cdc-8816-b3dea695f24a
type: extract_recursive
status: completed
result: {"total_memories":4,"message":"Extraction complete. Created 4 memory nodes."}
created_at: 2026-03-12 13:14:49
started_at: 2026-03-12 13:14:49
completed_at: 2026-03-12 13:16:21
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:02-dashboard.md","document_title":"02-dashboard.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":4,"current_depth":1,"extracted_node_ids":["376d5b05-c2e2-45a7-bd3d-0c59d8194d8e","9288785a-25bb-43c4-9354-57c2793a0520","16c4b69b-5492-4d20-801c-57c14dad4b53","9f82e1c9-cb91-4658-b5f7-8b2dd79dceb9"],"skip_analysis":true,"last_step_request_at":1773321381,"root_node_id":"376d5b05-c2e2-45a7-bd3d-0c59d8194d8e","base_tag":"document","current_block_title":"Top Navigation Bar","step_locked_at":1773321381}


id: 00240537-2eb1-42d6-869f-5835751eaaa6
type: extract_recursive
status: completed
result: {"total_memories":8,"message":"Extraction complete. Created 8 memory nodes."}
created_at: 2026-03-12 13:17:40
started_at: 2026-03-12 13:17:40
completed_at: 2026-03-12 13:20:40
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:03-spirits.md","document_title":"03-spirits.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":8,"current_depth":1,"extracted_node_ids":["85fb774c-e8e7-4611-91cd-44a19a072386","49196b83-0bc8-49c0-a5cb-2b991d57e65c","aef300c2-1723-48a7-9ab4-b83c9342ef57","c39275dc-8438-45f5-acca-639882d9ac61","10512eb2-de99-45b3-b749-a8db5f5e9379","273a9c62-6d2f-4ae8-a817-d396fd5d0e28","f53218b5-f2aa-4adb-902c-e88a44f11e67","bcb05ed5-9d44-4628-be3d-684beac42b73"],"skip_analysis":true,"last_step_request_at":1773321640,"root_node_id":"85fb774c-e8e7-4611-91cd-44a19a072386","base_tag":"document","current_block_title":"Spirit Creation and Progression","step_locked_at":1773321640}


id: c25bb668-88ff-4707-986a-b29ff382e2a9
type: extract_recursive
status: completed
result: {"total_memories":13,"message":"Extraction complete. Created 13 memory nodes."}
created_at: 2026-03-12 13:21:11
started_at: 2026-03-12 13:21:11
completed_at: 2026-03-12 13:27:18
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:04-cq-memory.md","document_title":"04-cq-memory.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":13,"current_depth":1,"extracted_node_ids":["a26434c2-2f0a-4a19-8851-8757e21ddbf1","df4f6b2b-ec31-4523-a509-90382945cc1d","981c25eb-0e25-4ef9-974b-e1c6b2cf98da","e7e9d105-0e1a-4c44-9f17-dbf2d3144ab7","e9b83b50-ce81-4148-9f3d-6c9786fe989e","b7adbc37-239e-41fc-917c-62b612be0cf6","d53d081b-6f67-4155-8069-711b2449468c","e6da62d1-5272-4316-8fa4-652f2a8ad291","972d7c0c-cdbe-4a67-832d-e5a48187bf4c","c2108434-8b74-46a0-845d-5abb287a9cec","84185171-3b5f-487e-b788-38c288c23e88","83873d3c-ac7d-4c56-b222-fd9ecb768d1d","e70f4f2c-63c7-4af3-8110-b37bf4eaf28a"],"skip_analysis":true,"last_step_request_at":1773322038,"root_node_id":"a26434c2-2f0a-4a19-8851-8757e21ddbf1","base_tag":"document","current_block_title":"Relationship Types","step_locked_at":1773322038}


id: d81ecdfe-8ad9-4ce8-a4eb-6470062c1adf
type: extract_recursive
status: completed
result: {"total_memories":6,"message":"Extraction complete. Created 6 memory nodes."}
created_at: 2026-03-12 13:32:42
started_at: 2026-03-12 13:32:42
completed_at: 2026-03-12 13:35:41
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:05-file-browser.md","document_title":"05-file-browser.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":6,"current_depth":1,"extracted_node_ids":["ac49a47f-9772-4591-932c-4504d4ce6a1b","9fc3589c-f983-4f00-8ed1-296e059d7fac","697c5176-557a-4939-bbbd-f565956940af","ff00df6c-c3e8-4a0d-8fb9-33ee914ccc57","e3a976b6-6989-4cf5-8a77-b1236d687cd1","d68be241-4b63-4c48-8309-69a2950cf0af"],"skip_analysis":true,"last_step_request_at":1773322541,"root_node_id":"ac49a47f-9772-4591-932c-4504d4ce6a1b","base_tag":"document","current_block_title":"Mobile Support and Storage Architecture","step_locked_at":1773322541}


id: 36864a9c-0513-437c-92f4-3853bccf642a
type: extract_recursive
status: completed
result: {"total_memories":5,"message":"Extraction complete. Created 5 memory nodes."}
created_at: 2026-03-12 13:36:18
started_at: 2026-03-12 13:36:18
completed_at: 2026-03-12 13:38:22
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:06-cq-chat.md","document_title":"06-cq-chat.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":5,"current_depth":1,"extracted_node_ids":["b55220a6-be4e-41cf-a5b2-479ae9733feb","3b059a1f-d20f-491f-a5aa-65bba791b45d","ff4b2e53-5fdb-49c7-a205-48817beab2ff","f77c05d7-f1e2-4d0b-ba3e-2465ee3145a8","34ad3ed6-59be-4d32-9cd0-792bd512d00c"],"skip_analysis":true,"last_step_request_at":1773322702,"root_node_id":"b55220a6-be4e-41cf-a5b2-479ae9733feb","base_tag":"document","current_block_title":"Technical Architecture and Privacy","step_locked_at":1773322702}


id: 7353be6f-4346-475c-bb91-0aeb08bfd5a0
type: extract_recursive
status: completed
result: {"total_memories":8,"message":"Extraction complete. Created 8 memory nodes."}
created_at: 2026-03-12 13:39:20
started_at: 2026-03-12 13:39:20
completed_at: 2026-03-12 13:42:21
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:07-cq-contacts.md","document_title":"07-cq-contacts.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":8,"current_depth":1,"extracted_node_ids":["a66ca7d8-5440-4462-8478-92fc9f09328c","7ca97fb5-e521-48f7-be82-39799329847b","ebe1af06-27db-4edb-abcd-bcfd6adb99f1","aadc9369-e6f7-4823-b8c0-59e30f9e2143","db4091ba-59d2-41a2-a1a2-7e11c746bc9e","33de0555-679f-4e3c-bdd5-6f38292b8a0e","3934e812-46aa-488a-a6d2-ab56ea6ccc86","4f300b5b-b718-437e-bab8-49aa61546714"],"skip_analysis":true,"last_step_request_at":1773322941,"root_node_id":"a66ca7d8-5440-4462-8478-92fc9f09328c","base_tag":"document","current_block_title":"Federation Protocol & Privacy","step_locked_at":1773322941}


id: 0d4e96ae-1c89-4dae-92bb-37cd792d10cf
type: extract_recursive
status: completed
result: {"total_memories":11,"message":"Extraction complete. Created 11 memory nodes."}
created_at: 2026-03-12 13:42:52
started_at: 2026-03-12 13:42:52
completed_at: 2026-03-12 13:48:47
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:08-cq-share.md","document_title":"08-cq-share.md","max_depth":2,"needs_init":false,"pending_blocks":[{"title":"Methods for Creating Shares","summary":"Step-by-step instructions for sharing items via File Browser, Memory Explorer, or CQ Share page.","start_line":47,"end_line":48,"is_leaf":false,"content":"---\n","tags":["creation-process","file-browser","memory-explorer","cq-share"],"parent_node_id":"30770643-51d9-4460-8d73-acbeeea5ee5d","depth":2}],"processed_count":10,"current_depth":1,"extracted_node_ids":["e3562b91-45ea-49ec-a6ae-2f1d2c256c3d","93773695-e3ff-4eb0-be79-8ffa69bfc7d6","30770643-51d9-4460-8d73-acbeeea5ee5d","a4102387-181b-467a-9de7-edeb48f554e0","4d8a2d04-0376-4274-818b-160b12166db4","4c65b13b-e579-4e5b-99c1-8c216affde3b","ff9a208f-151d-43df-9869-4df9f9dd2f1a","c948f87d-5941-4d4d-84a2-98e896b44105","033b4c10-b865-4082-b222-2b80e3325247","d0105e38-e572-40e8-9841-f88321a97df3"],"skip_analysis":true,"last_step_request_at":1773323325,"root_node_id":"e3562b91-45ea-49ec-a6ae-2f1d2c256c3d","base_tag":"document","current_block_title":"Search & Filter Functionality"}


id: e4a5706e-d431-4e7e-9cee-fd14f5b92151
type: extract_recursive
status: completed
result: {"total_memories":8,"message":"Extraction complete. Created 8 memory nodes."}
created_at: 2026-03-12 13:49:58
started_at: 2026-03-12 13:49:58
completed_at: 2026-03-12 13:53:19
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:09-cq-profile.md","document_title":"09-cq-profile.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":8,"current_depth":1,"extracted_node_ids":["9f70573d-ea1e-4d50-939b-05a989db6084","a1439ab3-f65b-4de5-a309-e171ebaf073e","0c573bc1-8254-4f1f-b1a4-f39dca6c24d5","9552e58a-dc05-4b5e-970c-2c95a80fc2b6","b26fdb3a-aa6b-4e62-ad8c-b621dede41ac","caa65c7d-fc3f-41ee-864c-cbe1d1deecae","1fb09f94-b7b5-4c69-bcc1-f221287c0184","e1c3943f-7e5e-4e20-b8b5-bece58227459"],"skip_analysis":true,"last_step_request_at":1773323599,"root_node_id":"9f70573d-ea1e-4d50-939b-05a989db6084","base_tag":"document","current_block_title":"User Interaction and Access Levels","step_locked_at":1773323599}


id: f7f4d810-2039-449f-a937-769fffdaec76
type: extract_recursive
status: completed
result: {"total_memories":8,"message":"Extraction complete. Created 8 memory nodes."}
created_at: 2026-03-12 13:58:03
started_at: 2026-03-12 13:58:03
completed_at: 2026-03-12 14:00:34
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:10-settings.md","document_title":"10-settings.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":8,"current_depth":1,"extracted_node_ids":["bb33fbfe-33f1-4c1d-a318-a43d904847ff","6b6c8c5b-6836-45b0-91ce-c68c09c33db8","47b58ff8-0f88-4aec-b8be-6ef831437dbf","dcfc9c0a-b1ac-4c97-8643-3f495d770a3d","aa84ecfe-cf77-4e17-9850-d4b41884545a","9c74d022-8fb4-4539-b79a-0af27eec0354","651ec2a7-893b-4e84-9fc0-60a1ffab2539","07d73807-3bef-4bbb-bf74-94627323cee3"],"skip_analysis":true,"last_step_request_at":1773324034,"root_node_id":"bb33fbfe-33f1-4c1d-a318-a43d904847ff","base_tag":"document","current_block_title":"Settings Navigation Sidebar","step_locked_at":1773324034}


id: 224e52f1-1d1d-49f1-af14-6a2cd8c3cb51
type: extract_recursive
status: completed
result: {"total_memories":6,"message":"Extraction complete. Created 6 memory nodes."}
created_at: 2026-03-12 14:03:42
started_at: 2026-03-12 14:03:42
completed_at: 2026-03-12 14:06:48
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:11-backup.md","document_title":"11-backup.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":6,"current_depth":1,"extracted_node_ids":["6f6281f0-0ae6-4ec8-b829-a07b383d2baa","f10414d1-5c2c-4f68-9977-d71212e8d9af","ce8748d3-07f3-458d-b031-05996cd7ecc8","10447049-2745-48a8-a44e-219768498463","b0814698-e1bf-405e-bbd0-89be0c75d3a2","96095a4e-b62c-475e-a2aa-80fa6ee37e4d"],"skip_analysis":true,"last_step_request_at":1773324408,"root_node_id":"6f6281f0-0ae6-4ec8-b829-a07b383d2baa","base_tag":"document","current_block_title":"Best Practices","step_locked_at":1773324408}


id: 8fd3f498-e2be-4eee-9c10-e81b17dc7cc3
type: extract_recursive
status: completed
result: {"total_memories":7,"message":"Extraction complete. Created 7 memory nodes."}
created_at: 2026-03-12 14:08:34
started_at: 2026-03-12 14:08:34
completed_at: 2026-03-12 14:12:00
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:12-administration.md","document_title":"12-administration.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":7,"current_depth":1,"extracted_node_ids":["1f4aba06-d24c-48de-90c1-a09640942ada","fe4eef3d-8d4f-4188-986c-39a43ca9913b","e3bcb9b7-f7cb-48b2-b798-50ecd96d781c","e233a100-5775-4040-a1b3-7b3fe93470da","2a74f7ec-6dc6-4e4b-a87a-5ce5de772401","485942bf-31ec-4d61-9bc2-b3f9777e1844","6c522150-ff8d-42ac-a776-58f6699ff927"],"skip_analysis":true,"last_step_request_at":1773324720,"root_node_id":"1f4aba06-d24c-48de-90c1-a09640942ada","base_tag":"document","current_block_title":"Migration Requests","step_locked_at":1773324720}


id: 053b51fb-707b-4491-a1e9-0e2789fb1534
type: extract_recursive
status: completed
result: {"total_memories":7,"message":"Extraction complete. Created 7 memory nodes."}
created_at: 2026-03-12 14:12:58
started_at: 2026-03-12 14:12:58
completed_at: 2026-03-12 14:15:50
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:13-installation.md","document_title":"13-installation.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":7,"current_depth":1,"extracted_node_ids":["adcf2a61-15b8-45d5-a10d-3f0ff414bff0","02219640-3973-4d9f-bbb1-5c2f490ed3b5","aa033ef6-d33a-4289-9fbb-fb893247be20","e47091aa-4b2b-4925-a2ed-f156fb58e4a9","fcec0402-59ac-42bb-b213-6d2270fce582","6d45f077-3b4a-43a8-9e58-bc3da291393c","fdba9b8b-d1a7-475c-bf84-03db9e868a65"],"skip_analysis":true,"last_step_request_at":1773324950,"root_node_id":"adcf2a61-15b8-45d5-a10d-3f0ff414bff0","base_tag":"document","current_block_title":"CQ AI Gateway Integration","step_locked_at":1773324950}


id: fda0dd76-3815-43f2-978b-606b919a0113
type: extract_recursive
status: completed
result: {"total_memories":11,"message":"Extraction complete. Created 11 memory nodes."}
created_at: 2026-03-22 12:51:30
started_at: 2026-03-22 12:51:30
completed_at: 2026-03-22 12:54:42
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual-light.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:10-settings.md","document_title":"10-settings.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":11,"current_depth":1,"extracted_node_ids":["c7bcab28-6c5c-485a-a66f-455bf5f892d6","9a5e7dae-6538-4f70-b79c-89190537784c","dc79f516-1d98-4380-a139-164c40e0536f","5ebdf78e-1849-452d-9714-a73038529ca7","2cf0a089-6493-4193-8d41-9eb203f50c24","eec8f8e8-50b3-412d-9eaf-0ff566204624","46be8f4b-7595-4c41-97bd-a9fc496ed86d","286afe7a-b3ea-4939-9d7a-18ce2bea1353","bedece77-fe31-4c8b-b218-481e915a6018","38b43a71-1947-4515-a83c-74ef252cc74e","1797f8cb-c1a4-468a-8b74-3fa36968c00b"],"skip_analysis":true,"last_step_request_at":1774184082,"root_node_id":"c7bcab28-6c5c-485a-a66f-455bf5f892d6","base_tag":"document","current_block_title":"Account Migration","step_locked_at":1774184082}


id: 9026eb1e-0b45-413e-9e45-e757035c600c
type: extract_recursive
status: completed
result: {"total_memories":7,"message":"Extraction complete. Created 7 memory nodes."}
created_at: 2026-03-22 12:54:53
started_at: 2026-03-22 12:54:53
completed_at: 2026-03-22 12:57:54
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual-light.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:14-cq-feed.md","document_title":"14-cq-feed.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":7,"current_depth":1,"extracted_node_ids":["ab535c88-0269-44cd-8f4d-b01435d4710e","0a97200e-a575-499b-9ffe-a9b30837050d","e93c44fb-3e1d-4de2-aa28-1db1b899e648","07485303-d8fc-4684-be1f-96472d0d3fdc","db5c0c80-42c0-4b5d-bc8a-5c1b0bb50119","817c8e99-800f-40b1-a146-eb5cdfd79d0f","5f161884-7b5c-4f24-8d9d-7503d2d3f770"],"skip_analysis":true,"last_step_request_at":1774184274,"root_node_id":"ab535c88-0269-44cd-8f4d-b01435d4710e","base_tag":"document","current_block_title":"Federation Architecture","step_locked_at":1774184274}


id: d79f19e6-a5bc-438b-b8c6-519af5ae27a6
type: extract_recursive
status: completed
result: {"total_memories":9,"message":"Extraction complete. Created 9 memory nodes."}
created_at: 2026-03-22 12:59:42
started_at: 2026-03-22 12:59:42
completed_at: 2026-03-22 13:02:26
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual-light.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:09-cq-profile.md","document_title":"09-cq-profile.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":9,"current_depth":1,"extracted_node_ids":["21b29699-532e-4fea-b756-09650783a31c","938842ba-7504-40bd-97d7-28cb8e150274","d35b0431-fd2e-4cd4-99dd-d12e0100eb64","6131c4a7-a1c7-4295-afc3-3d48d15be380","a3f9bc82-9c14-4921-9e37-a97826268412","f2b20559-bf71-4d5e-a3fd-1db90fd3ef29","aa8a072d-43e2-4f8b-a576-bcc5d827dbf8","686a18df-602e-4ef9-a743-7548335b645b","18e25bc0-5d35-496c-abf1-8648774b6035"],"skip_analysis":true,"last_step_request_at":1774184546,"root_node_id":"21b29699-532e-4fea-b756-09650783a31c","base_tag":"document","current_block_title":"User Interaction and Access Levels","step_locked_at":1774184546}


id: dea404d5-d529-4f50-bd2c-9bba21979651
type: extract_recursive
status: completed
result: {"total_memories":4,"message":"Extraction complete. Created 4 memory nodes."}
created_at: 2026-03-22 13:02:45
started_at: 2026-03-22 13:02:45
completed_at: 2026-03-22 13:03:57
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual-light.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:02-dashboard.md","document_title":"02-dashboard.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":4,"current_depth":1,"extracted_node_ids":["f23cb0bb-a933-4755-b86e-774473f99e5d","d248e654-cce2-47f5-8cfa-df823256886a","6768d38a-6b16-4b48-8a7c-928e5b540f1a","e281d271-dee1-402f-bfa9-c451d956c96f"],"skip_analysis":true,"last_step_request_at":1774184637,"root_node_id":"f23cb0bb-a933-4755-b86e-774473f99e5d","base_tag":"document","current_block_title":"Top Navigation Bar","step_locked_at":1774184637}


id: 1fba9774-a816-4cb9-b1d1-51c7bb196a08
type: extract_recursive
status: completed
result: {"total_memories":8,"message":"Extraction complete. Created 8 memory nodes."}
created_at: 2026-03-22 13:04:49
started_at: 2026-03-22 13:04:49
completed_at: 2026-03-22 13:07:33
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual-light.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:07-cq-contacts.md","document_title":"07-cq-contacts.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":8,"current_depth":1,"extracted_node_ids":["5c1d4226-1487-425c-a876-1d9a57c6e058","65f0c8c9-5667-4326-983b-ea28d6224bd1","a0d54d94-2d3c-4764-94e4-8c05548f866c","801a2309-1b49-4fea-9b0e-63811bfd49c9","053514be-6c8d-4eb4-bbe0-26e16618e0f6","5f6ed2d1-f034-4fe2-9616-f780394b8eee","9dff485b-1e98-421d-9651-00cf55e1c512","6f03b33e-d631-48c5-a85f-b0cb00b6ca37"],"skip_analysis":true,"last_step_request_at":1774184853,"root_node_id":"5c1d4226-1487-425c-a876-1d9a57c6e058","base_tag":"document","current_block_title":"Federation Protocol","step_locked_at":1774184853}


id: 81214883-889b-43d5-ad8c-a0125bbd7ae4
type: extract_recursive
status: completed
result: {"total_memories":6,"message":"Extraction complete. Created 6 memory nodes."}
created_at: 2026-03-22 13:07:51
started_at: 2026-03-22 13:07:51
completed_at: 2026-03-22 13:09:26
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual-light.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:00-introduction.md","document_title":"00-introduction.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":6,"current_depth":1,"extracted_node_ids":["ed80ee81-892a-4356-9a1b-c30f5200cb02","fcedcace-094a-43e8-ab50-4b8bfcc6b552","29feed29-6c8f-483b-9b9a-a119a7ee7755","b2baf1a4-1547-4c2f-bc0c-31a1ca228a58","3aac084f-8acc-4ab5-bdb6-c866da238217","b6059177-ac86-4ec5-8e30-b075531ab4fb"],"skip_analysis":true,"last_step_request_at":1774184966,"root_node_id":"ed80ee81-892a-4356-9a1b-c30f5200cb02","base_tag":"document","current_block_title":"About and Project Links","step_locked_at":1774184966}


id: f1d34b0e-2d20-4572-a9ba-d26cf561b76f
type: extract_recursive
status: completed
result: {"total_memories":8,"message":"Extraction complete. Created 8 memory nodes."}
created_at: 2026-03-22 13:13:50
started_at: 2026-03-22 13:13:50
completed_at: 2026-03-22 13:15:59
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual-light.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:CITADELQUEST.md","document_title":"CITADELQUEST.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":8,"current_depth":1,"extracted_node_ids":["388726da-f2bc-4e76-a6fe-84513b160a93","d74db975-0e53-48c5-acf9-89341aed88e0","f50c6cee-cb51-430c-9946-71b6bd397a6e","15d5b4f0-e5e8-476d-8481-abd0ee59c1ac","87a30a49-d955-4153-92a8-790da5778992","435cb822-7d90-4d52-a3ea-f7f6ee6691e9","cd3c709f-84fd-42e3-b25d-734002a02b81","0a222aba-70c1-4a22-bcb3-3472084fb4ec"],"skip_analysis":true,"last_step_request_at":1774185359,"root_node_id":"388726da-f2bc-4e76-a6fe-84513b160a93","base_tag":"document","current_block_title":"Getting Started and Support","step_locked_at":1774185359}


id: bb70bb72-beaa-4728-b793-ece5834accba
type: extract_recursive
status: completed
result: {"total_memories":8,"message":"Extraction complete. Created 8 memory nodes."}
created_at: 2026-03-22 17:16:31
started_at: 2026-03-22 17:16:31
completed_at: 2026-03-22 17:18:47
payload:
{"target_pack":{"projectId":"general","path":"\/memory\/libs\/packs","name":"CQ-User-Manual-light.cqmpack"},"source_type":"document","source_ref":"general:\/CQ-User-Manual:09-cq-profile.md","document_title":"09-cq-profile.md","max_depth":2,"needs_init":false,"pending_blocks":[],"processed_count":8,"current_depth":1,"extracted_node_ids":["dd40e138-a40c-40b3-bcea-733c8528cf98","e9485b3e-c6ec-4630-90b8-4a3c2ecfcae7","6d605571-2f26-49dc-b6b2-4731a876680e","793a341d-107b-434d-96ec-6717d147e67c","b9905007-e9cb-477e-9a72-87ab9d4bab49","ab54e914-5441-4f6f-823b-0bcc238ff9ea","51b3f29a-7dce-43c0-bf22-7a4f6ed61ae6","3c2e49fa-9e84-4b17-9991-6770b3ad597b"],"skip_analysis":true,"last_step_request_at":1774199927,"root_node_id":"dd40e138-a40c-40b3-bcea-733c8528cf98","base_tag":"document","current_block_title":"User Interaction and Access","step_locked_at":1774199927}


# memory_sources

source_ref: general:/CQ-User-Manual:03-spirits.md
source_type: document
title: 03-spirits.md
created_at: 2026-03-12 13:17:40
content:
# Spirits — Your AI Companions

Spirits are the heart of CitadelQuest — personal AI companions that learn, remember, and grow alongside you. Each Spirit has its own personality, memory, and capabilities.

---

## Spirits List

**Route**: `/spirits`

The Spirits page shows all your AI companions as cards. Each card displays:
- Spirit icon with custom color
- Spirit name
- Level and experience points (XP)
- Quick access to Spirit chat and profile

From here you can create new Spirits or click on an existing one to manage it.

---

## Spirit Profile

**Route**: `/spirit/{id}`

The Spirit Profile is your Spirit's home page, divided into several sections:

### Identity & Level
- **Spirit icon** with custom color and glow effect
- **Name** and **Level** indicator
- **Experience bar** showing progress to next level (XP earned through interactions)

### AI Model
- **Model selector** — click to compare and select from available AI models
- Models include options from providers like Anthropic (Claude), Google (Gemini), xAI (Grok), and more
- Your selection determines the AI powering this Spirit's responses

### System Prompt
- **Custom instructions** — define how your Spirit should behave, its personality, areas of expertise, and knowledge
- **Advanced Prompt Builder** — opens a detailed editor for fine-tuning the system prompt with:
  - Memory Type selection (Legacy .md files, Reflexes, Memory Agent)
  - Structured sections for personality, expertise, and behavior rules
- Click **Save** to apply changes

### Memory Explorer Preview
- **3D graph visualization** — a miniature preview of your Spirit's knowledge graph
- Shows pack count, node count, and relationship count
- **Explore** button opens the full Memory Explorer filtered to this Spirit
- **Memory Agent** badge shows which memory processing mode is active

### Recent Interactions
- Log of Spirit interactions with timestamps
- Shows XP earned and interaction types (creation, conversation, tool use)

### Conversations
- List of all conversations with this Spirit
- Click the chat button to open a conversation
- Create new conversations with the "+" button

---

## Spirit Chat

Spirit Chat is a **modal overlay** — it opens on top of any page, so you never lose your place. Access it by:
- Clicking the **Spirit icon** in the top navigation bar
- Clicking a **conversation** in the Spirit Profile

### Chat Interface
- **Message input** — type your message and press Enter or click Send
- **AI response** — your Spirit's reply with full Markdown formatting (code blocks, lists, tables, etc.) and AI Tools results
- **Memory synthesis** — when relevant, the chat shows which memories were recalled:
  - Expandable panel with recalled memory nodes
  - Mini 3D graph visualization of memory connections and highlighted activated nodes
  - Synthesis quality indicator (high/medium/low)
  - Tags showing matched keywords
- **Used context window indicator** — top border of input area used as decent yet informative progress bar

### Attachments
- **Image attachments** — attach images to your messages
- **PDF attachments** — attach PDF documents for your Spirit to analyze (and makes it available for memory extraction)

### Controls
- **Temperature slider** — adjust the creativity/randomness of your Spirit's responses
- **Info button** — shows Spirit current AI Model name (context window size)
- **Extract Memory & Close** — extract the conversation into a CQ Memory Pack and close the conversation in one click

### AI Tools

Your Spirit can use various tools during conversation to help you:

| Tool | Description |
|------|-------------|
| **getFileContent** | Read files from your File Browser |
| **searchFile** | Search for files in your File Browser |
| **manageFile** | Create, rename, move, or delete files |
| **updateFileEfficient** | Edit specific parts of files with precision |
| **getProjectTree / listFiles** | Browse your file system |
| **memoryStore** | Save important information to memory |
| **memoryRecall** | Search through stored memories |
| **memoryExtract** | Extract knowledge from documents into memory graphs (with automatic relationship analysis) |
| **memorySource** | Look up original source content for a memory |
| **fetchURL** | Read web page content |
| **imageEditorSpirit** | Generate and edit images using AI |
| **diffusionArtistSpirit** | Generate images using AI diffusion models |

> Tools are used automatically when relevant — just ask your Spirit naturally and it will decide which tools to use.

---

## Creating a New Spirit

1. Go to `/spirits`
2. Click **Create Spirit** (or it opens automatically if you have no Spirits)
3. Choose a **name**, **AI model**, and **color**
4. Your Spirit is created with starter memory nodes (identity nodes for both Spirit and user)
5. Start your first conversation!

---

## Spirit Experience & Leveling

Spirits earn **XP** (experience points) through interactions:
- **Conversations** — chatting with your Spirit
- **Tool usage** — when Spirit uses its tools to help you
- **Memory operations** — when Spirit stores or processes memories

As your Spirit levels up, the experience bar fills and the level number increases. This gamification element makes the collaboration journey more engaging.


source_ref: general:/CQ-User-Manual:04-cq-memory.md
source_type: document
title: 04-cq-memory.md
created_at: 2026-03-12 13:21:11
content:
# CQ Memory — Knowledge Graphs

CQ Memory is CitadelQuest's powerful knowledge management system. It transforms unstructured content — documents, web pages, conversations — into **interactive 3D knowledge graphs** that your Spirits can use for persistent, contextual memory.

---

## Key Concepts

### Memory Pack (`.cqmpack`)
A standalone knowledge graph stored as a portable SQLite database file. Each pack contains:
- **Nodes** — individual pieces of knowledge (facts, insights, preferences, thoughts)
- **Relationships** — typed connections between nodes (relates to, contradicts, reinforces, etc.)
- **Tags** — flexible labels for filtering and search
- **Source content** — the original documents that knowledge was extracted from

Packs are fully self-contained and portable — they can be shared between users and Citadels.

### Memory Library (`.cqmlib`)
A collection that groups multiple Memory Packs together. Libraries help you organize related knowledge:
- Enable/disable individual packs
- Set priorities for which packs are searched first
- Tag packs for easy categorization

### Memory Node
A single unit of knowledge. Each node has:
- **Content** — the actual information
- **Summary** — short description shown on the graph
- **Category** — knowledge, fact, preference, thought, conversation, or internet
- **Importance** — how relevant this memory is (decays over time if not accessed)
- **Source tracking** — where this memory came from

### Relationships
Connections between nodes, each with a type:

| Type | Meaning | Visual |
|------|---------|--------|
| **RELATES_TO** | General semantic connection | Blue edge |
| **REINFORCES** | Supporting/confirming information | Green edge |
| **CONTRADICTS** | Conflicting information | Red edge |
| **PART_OF** | Hierarchical parent-child | White/Grey edge |

---

## Memory Explorer

**Route**: `/memory`

The Memory Explorer is the main interface for viewing and managing your knowledge graphs.

### Layout

- **Left sidebar** — Node list with search, source document sections, extract and analyze tools
- **Center** — Interactive 3D graph visualization
- **Top bar** — Library selector, Pack selector, info

### 3D Graph Visualization

The centerpiece of Memory Explorer — an interactive 3D force-directed graph rendered with Three.js:
- **Nodes** appear as colored spheres (color = category)
- **Edges** connect related nodes (color = relationship type)
- **Click** a node to see its details (content, category, importance, tags, source)
- **Hover** over a node to highlight its connections and show the node's title
- **Scroll** to zoom, **drag** to rotate, **right-drag** to pan
- **Click+Ctrl** zoom to node + set camera center of rotation
- **Delete** key press to show confirm window, delete node and its children
- **Node size** reflects importance

### Library Selector

The dropdown at the top lets you switch between:
- **All Packs** — shows every `.cqmpack` file in your project
- **Specific libraries** — shows only packs in that library
- When viewing a Spirit's memory (`/memory?spirit={id}`), only that Spirit's library is shown

### Pack Selector

Next to the library selector, choose which pack to visualize. Shows:
- Pack name
- Node count badge
- Relationship count badge
- Dropdown for Pack management (Add/Remove from Library, Show details with AI usage stats, Delete)

### Creating a New Pack

1. Click the **+** button next to the pack selector
2. Enter a name for your new pack
3. The pack is created and automatically added to the selected library

### Creating a New Library

1. Click the **+** button next to the library selector
2. Enter a name and optional description
3. The library is created at the default location

---

## Memory Extraction

The Extract Panel lets you add knowledge from various sources into a pack.

### Source Types

#### File
Upload or select a file from your File Browser. Supported: text documents, PDFs, code files, and more.

#### URL
Enter a web page URL. CitadelQuest fetches the content and extracts knowledge from it.

#### Text
Paste any text directly. Useful for quick notes, copied content, or manual input.

#### Conversation
Select a Spirit and one of its conversations. The conversation transcript is extracted into structured knowledge.

### Extraction Process

1. Select your source type and provide the content
2. Click **Start Extraction**
3. Watch the 3D graph update in real-time as nodes are created:
   - Documents are processed recursively — the AI splits content into logical blocks, creating a hierarchical structure
4. After extraction completes, **relationship analysis** runs automatically, if selected in the extraction settings — the AI discovers connections between all nodes
5. The complete knowledge graph is stored in the selected pack (AI usage logged)

> **AI Credits**: Extraction uses CQ AI Gateway credits. The Pack Details modal shows complete token usage and credit cost statistics.

---

## Memory Analyze Panel

After extracting knowledge, you can run relationship analysis to discover connections between nodes.

### Whole Pack Analysis
Analyzes all nodes in the selected Memory Pack to discover relationships across the entire knowledge graph.

### Selected Root Node Analysis
Focused analysis on a specific branch (tree) of nodes — useful for analyzing relationships within a particular document or topic without re-analyzing the entire pack.

The analysis uses a hierarchical strategy that's optimized for efficiency — intra-document leaf pairs, then cross-document root-gating with recursive drill-down.

### Active CQ Memory Jobs

A status icon in the **global app footer** shows when memory jobs (extraction or analysis) are actively running. This is visible from any page, so you always know when your knowledge graph is being processed.

---

## Spirit Memory Integration

Each Spirit has its own Memory Library containing one or more packs. This is how Spirits remember things:

### Memory Types

| Type | Description |
|------|-------------|
| **Reflexes** | Fast, automatic memory recall. When you send a message, your Spirit's memory is searched for relevant context, which is included in the conversation. |
| **Memory Agent** | Advanced mode — a sub-agent AI synthesizes recalled memories, evaluates relevance, and expands graph connections before responding. Higher quality, uses more credits. |
| **Legacy (.md files)** | Older text-based memory system (backward compatibility). |

### How Memory Recall Works

1. You send a message to your Spirit
2. The system searches all enabled packs in the Spirit's library
3. Relevant memory nodes are recalled based on keyword matching
4. For Memory Agent mode: a sub-agent AI evaluates and synthesizes the recalled memories
5. The recalled context is provided to your Spirit alongside your message
6. Your Spirit responds with awareness of past knowledge

### Memory Synthesis Display

In Spirit Chat, recalled memories appear above the Spirit's response:
- **Expandable panel** showing which memories were used
- **Mini 3D graph** visualizing the recalled nodes and their connections
- **Score badges** showing relevance strength
- **Tags** for quick identification
- **"Graph" badges** for nodes discovered via relationship expansion

---

## Sharing Memory Packs

You can share your Memory Packs with CQ Contacts or publicly via **CQ Share**:

1. In the Memory Explorer, select a pack and use the pack dropdown menu → **Share**
2. Or go to the **CQ Share** management page (`/share`) and create a share for any pack
3. Choose scope: **Public** (anyone with the link) or **CQ Contacts** (authenticated contacts only)

When a CQ Contact downloads your shared pack, it **auto-syncs** — any updates you make to the original pack are automatically reflected in their copy the next time they open their Memory Explorer.

See [CQ Share](08-cq-share.md) for the full sharing guide.

---

## Use Cases

- **Book/Document Analysis** — Upload PDFs or documents, extract key concepts, see information structure at a glance
- **Research** — Load multiple sources into one library, visualize contradictions and reinforcements across sources
- **Spirit Knowledge** — Build specialized knowledge bases for your Spirits
- **Personal Wiki** — Organize your knowledge into themed packs
- **Web Research** — Extract knowledge from URLs and see connections between different web sources
- **Conversation Archives** — Extract insights from your Spirit conversations into permanent knowledge
- **Relationship Discovery** — Run analysis to find contradictions, reinforcements, and connections across different knowledge sources
- **Shared Knowledge** — Share curated knowledge graphs with friends, team members, or the public via CQ Share


source_ref: general:/CQ-User-Manual:05-file-browser.md
source_type: document
title: 05-file-browser.md
created_at: 2026-03-12 13:32:42
content:
# File Browser — Personal Cloud

The File Browser is your personal cloud storage within CitadelQuest. Your files are stored on your server, always accessible, and fully integrated with your AI Spirits.

**Route**: `/file-browser`

---

## Interface

The File Browser offers two views, switchable via toggle buttons:

### Tree View
A hierarchical tree showing your complete folder structure. Click folders to expand/collapse, click files to select them.

### File Preview
- Size
- Last modified date
- Action buttons (download, rename, delete)
- content preview for images, pdf, md, txt

---

## Operations

### Uploading Files
1. Click the **Upload** button
2. Select or drag&drop files from your device
3. Files are uploaded to your current directory

### Creating Folders
1. Click the **New Folder** button
2. Enter a name
3. The folder is created in your current directory

### Creating Files
1. Click the **New File** button
2. Enter a filename
3. An empty file is created — you can edit it or let your Spirit fill it with content

### Downloading
Click the **download** icon next to any file to download it to your device. **download in ZIP** for directories

### Renaming
Click the **rename** icon, enter the new name, and confirm.

### Deleting
Click the **delete** icon and confirm the deletion.

### Sharing
Click the **Share** button on any file to create a CQ Share link. You can choose to share publicly (anyone with the link) or with CQ Contacts only. See [CQ Share](08-cq-share.md) for details.

---

## AI Integration

Your Spirits have full access to the File Browser through their tools:

- **Read files** — Spirit can read any file content to help you
- **Create files** — Spirit can create new files (notes, documents, code, etc.)
- **Edit files** — Spirit can make precise edits to existing files
- **Manage files** — Spirit can rename, move, or delete files
- **Browse** — Spirit can list directory contents to understand your file structure

This means you can ask your Spirit things like:
- "Create a shopping list in my notes folder"
- "Read the document I uploaded and summarize it"
- "Update the recipe file with the new ingredients"
- "Organize my files into folders by topic"

---

## Mobile Support

The File Browser is fully responsive and optimized for mobile devices:
- Touch-friendly interface
- Icon-based mobile navigation
- Responsive layout adapting to screen size

---

## Storage

Your files are stored in your personal data directory on the server. The Dashboard shows your current storage usage breakdown (Database, User Data, Backups).

> Files are stored per-user — other users on the same Citadel cannot access your files.


source_ref: general:/CQ-User-Manual:06-cq-chat.md
source_type: document
title: 06-cq-chat.md
created_at: 2026-03-12 13:36:18
content:
# CQ Chat — Private Messaging

CQ Chat enables private, encrypted messaging between users across different CitadelQuest instances. Communication is direct — messages travel straight from one Citadel to another, with no corporate servers in between.

**Route**: `/cq-chat`

---

## Accessing CQ Chat

There are two ways to access your conversations:

### Navigation Dropdown
Click the **chat icon** in the top navigation bar to see:
- Recent conversations with preview of last message
- **Unseen message count** badge (green number)
- **New Chat** button to start a conversation
- Click any conversation to open it

### Full Chat Page
Navigate to `/cq-chat` for the complete chat interface with:
- Conversation list on the left
- Active conversation on the right
- Full message history with timestamps

---

## Conversations

### Starting a Conversation
1. Click the **New Chat** button (message+ icon)
2. Select a contact from your CQ Contacts
3. Start typing!

### Group Chats
CQ Chat supports group conversations with multiple participants from different Citadels.

### Message Features
- **Text messages** with real-time delivery
- **Image attachments**
- **Timestamps** showing when messages were sent
- **Read indicators** for message status
- **Unseen count** — badge shows how many unread messages you have

---

## How It Works

CQ Chat uses CitadelQuest's **Federation protocol** for cross-instance communication:
- Messages are sent directly between Citadels over HTTPS, secured with **CQ Contact API Keys**
- Your browser polls for new messages in real-time via the global updates endpoint
- Messages are stored only on the sender's and receiver's Citadels — nowhere else

> **Privacy**: Messages travel directly between Citadels. There is no central server that stores or relays your messages. Each user's messages are stored in their own personal database.


source_ref: general:/CQ-User-Manual:08-cq-share.md
source_type: document
title: 08-cq-share.md
created_at: 2026-03-12 13:42:52
content:
# CQ Share — Sharing Files & Knowledge

CQ Share lets you share files and CQ Memory Packs with your CQ Contacts or make them publicly accessible via a clean URL. It's the bridge between your personal data and the people you choose to share it with.

**Route**: `/share`

---

## Overview

CQ Share gives you two ways to share:

- **Public sharing** (scope: Public) — anyone with the link can access the shared item, no login required
- **CQ Contact sharing** (scope: CQ Contacts) — only your CQ Contacts can access, authenticated via their CQ Contact API keys

You can share two types of content:

| Type | Description |
|------|-------------|
| **Files** | Any file from your File Browser — images, documents, HTML pages, PDFs, archives, etc. |
| **CQ Memory Packs** | Knowledge graphs (`.cqmpack` files) — shareable and auto-syncable |

---

## CQ Share Management Page

The Share management page shows all your shared items with:
- **Title** — display name for the shared item
- **Type** — File or Memory Pack
- **Scope** — Public or CQ Contacts
- **URL** — the share link (click to copy)
- **Views** — download/access counter
- **Status** — Active or Paused
- **Display style** — how the item is rendered (Full, Preview, or Hidden)
- **Description** — optional markdown text shown alongside the item
- **Actions** — Edit, toggle active/paused, delete

### Search & Filter

The management page includes:
- **Search** — filter shares by title
- **Type filter** — show only Memory Packs or Files
- **Status filter** — show only Active or Paused items

---

## Creating a Share

### From File Browser

1. Select a file in the **File Browser**
2. Click the **Share** button in the file actions
3. Choose a **title** and **scope** (Public or CQ Contacts)
4. The share URL is generated automatically

### From Memory Explorer

1. Open **Memory Explorer** (`/memory`)
2. Select a Memory Pack
3. Use the pack management dropdown menu and click **Share**
4. Choose a **title** and **scope**

### From CQ Share Page

1. Go to **CQ Share** (`/share`)
2. Click **Create New Share**
3. Select the file or memory pack from your File Browser
4. Configure title, scope, and URL slug
5. Save — the share is now live

---

## Share URLs

Each shared item gets a clean, readable URL:

```
https://your-citadel.com/YourUsername/share/My-Shared-Document
```

- The URL slug is auto-generated from the title but can be customized
- URLs are unique per user
- Public shares can be accessed by anyone with the link — displayed inline by default (use `?download` to force download)
- CQ Contact shares require authentication

---

## Display Styles

Each share has a **display style** that controls how it appears on your profile and in CQ Explorer:

| Style | Description |
|-------|-------------|
| **Full** | Content is displayed inline — images shown full-size, HTML rendered, Memory Pack graphs visualized |
| **Preview** | Compact preview — image thumbnails, text excerpts |
| **Hidden** | Item is listed but content is not previewed |

Display style can be set per-share and optionally overridden at the group level (see Share Groups below).

---

## Share Descriptions

Each share can have an optional **description** written in Markdown. The description appears alongside the shared content on your profile and in CQ Explorer.

You can also control the **description position** relative to the content:
- **Above** — description appears above the content
- **Below** — description appears below the content
- **Left** — description on the left, content on the right
- **Right** — description on the right, content on the left

---

## Share Groups (Profile Content)

Share Groups let you organize your shared items into **content groups** — named, ordered collections that appear as tabbed navigation on your public profile and in CQ Explorer.

**Route**: `/settings/share-groups` (in Settings sidebar as **Profile Content**)

### Creating a Group

1. Go to **Settings** → **Profile Content**
2. Click **+ New Group**
3. Configure:
   - **Group Title** — name shown in the tab navigation (e.g. "Introduction", "Projects")
   - **Icon** — choose an icon for the group
   - **Icon Color** — pick a color for the icon
   - **URL Slug** — URL-friendly identifier
   - **Visibility** — Public, CQ Contacts, or specific contacts
   - **Active** — toggle the group on/off
   - **Show header** — toggle whether the group title is shown as a header
4. Click **Save**

### Adding Shares to a Group

1. Open a group in Profile Content settings
2. Click **+** to add existing shares
3. Select from your active shares
4. Drag to reorder items within the group

### Group Display Controls

Each item within a group can have its display style overridden:
- **From share** (inherit) — uses the share's own display style
- **Full** / **Preview** / **Hidden** — override for this group only

### How Groups Appear

- **Public profile page**: Groups appear as tabbed navigation below the profile header. Visitors click tabs to browse different content sections.
- **CQ Explorer**: When exploring a profile, groups appear as tabs in the main content area with the group's icon and title.

---

## Sharing Memory Packs

CQ Memory Pack sharing is especially powerful because of **auto-sync**:

### How It Works

1. You share a Memory Pack via CQ Share
2. A CQ Contact downloads it to their Citadel (see [CQ Explorer — Download to Citadel](07-cq-contacts.md))
3. The downloaded pack remembers where it came from (the source URL)
4. Whenever the contact opens their Memory Explorer, the pack automatically checks for updates
5. If you've added new knowledge to the original pack, it syncs automatically

### Use Cases

- **Shared knowledge bases** — maintain a pack and let contacts always have the latest version
- **Team documentation** — share project knowledge that stays up to date
- **Learning materials** — share curated knowledge graphs with friends or students

---

## Managing Shares

### Editing a Share

Click the edit icon on any share to change:
- **Title** — the display name
- **URL slug** — the URL path
- **Scope** — switch between Public and CQ Contacts
- **Display style** — Full, Preview, or Hidden
- **Description** — optional markdown text
- **Description position** — Above, Below, Left, or Right

### Pausing a Share

Toggle the **active/paused** status. Paused shares return a 404 — the content is not deleted, just temporarily hidden.

### Deleting a Share

Delete removes the share entry — the original file or memory pack is **not** deleted from your File Browser.

---

## Public Shares on Your Profile

If you have a **CQ Profile** public page enabled (see [CQ Profile](09-cq-profile.md)), your public shares can be displayed on your profile page in two ways:

1. **Share Groups** — organized as tabbed content sections (recommended)
2. **Shared items list** — a flat list of all public shares (toggle in profile settings)

Both can be enabled independently via profile visibility settings.

---

## Viewing Shares in CQ Explorer

When you explore any CQ Profile in CQ Explorer, you can see their public shared items and content groups. You can download files and Memory Packs directly to your Citadel. See [CQ Explorer](07-cq-contacts.md) for details.


source_ref: general:/CQ-User-Manual:11-backup.md
source_type: document
title: 11-backup.md
created_at: 2026-03-12 14:03:42
content:
# Backup & Restore

CitadelQuest includes a full backup system to protect your data. You can create, download, upload, and restore backups at any time.

**Route**: `/backup`

---

## Creating a Backup

1. Go to **Backup** (`/backup`)
2. Click **Create Backup**
3. CitadelQuest packages your complete data:
   - Personal database (all your settings, conversations, memories, contacts, etc.)
   - User data files (everything in your File Browser)
4. The backup appears in your backup list when complete

> Backups are stored as `.citadel` ZIP files on your server in your personal backup directory.

---

## Downloading a Backup

Click the **Download** button next to any backup to save it to your local device. This is recommended for:
- Off-site backup storage
- Before major updates
- Before account migration
- Peace of mind

---

## Uploading a Backup

1. Click **Upload Backup**
2. Select a backup `.citadel` ZIP file from your device
3. The file is uploaded to your Citadel

For large backup files, CitadelQuest uses **chunked uploading** — the file is split into smaller pieces and reassembled on the server, preventing timeout issues.

---

## Restoring from Backup

1. Click **Restore** next to the backup you want to restore
2. Confirm the action
3. CitadelQuest:
   - Restores the database from the backup
   - Restores your user data files
4. Refresh the page after restoration completes

---

## Deleting Backups

Click **Delete** next to any backup to remove it and free up storage space.

---

## Best Practices

- **Regular backups** — create backups periodically, especially before updates
- **Download copies** — keep backup copies on your local device or external storage
- **Before migration** — always create a fresh backup before migrating your account
- **Check storage** — monitor backup size on the Dashboard's Storage Usage panel


source_ref: general:/CQ-User-Manual:12-administration.md
source_type: document
title: 12-administration.md
created_at: 2026-03-12 14:08:34
content:
# Administration

The Administration panel is available to users with **Admin** privileges. The first registered user on a new CitadelQuest installation automatically becomes an admin.

**Route**: `/administration`

---

## Admin Dashboard

The main admin page shows:
- **User statistics** — total users, recently registered
- **Quick actions** — links to user management, updates, system settings
- **Recent users** — table of recently registered users

---

## User Management

**Route**: `/administration/users`

Manage all users on your Citadel:

### User List
- View all registered users with username, email, roles, and registration date
- **Search** to filter users by name or email

### User Actions
- **View Info** — see detailed user information in a modal dialog
- **Toggle Admin** — grant or revoke admin privileges (cannot remove your own admin role)
- **Reset Password** — generate a new password for a user
- **Delete User** — remove a user and their data (cannot delete yourself or the last admin)

---

## Application Updates

**Route**: `/administration/update/check/{step}`

Check for and install updates to CitadelQuest:

1. The system checks for available updates on GitHub
2. If a new version is available, you can download and install it
3. The updater:
   - Creates a safety backup
   - Downloads the new version
   - Applies file updates (preserves your `.env` configuration)
   - Runs database migrations
   - Clears and warms up the cache
4. Refresh the page to see the new version

> **Tip**: Always create a manual backup before updating, just in case.

---

## System Settings

The admin dashboard includes system-level configuration panels:

### User Registration

- **Toggle Registration** — enable or disable new user registration
- **Max users** — set a maximum number of allowed users (0 = unlimited)
- When disabled, the registration page shows a "Registration is currently disabled" message
- Useful for limiting access to your Citadel

### Homepage Redirect

Redirect the Citadel homepage (`https://your-citadel.com`) to a user's public CQ Profile page — for unauthenticated visitors only. Authenticated users still see their Dashboard.

1. Select a **Profile** user from the dropdown (any registered user)
2. **Toggle** the redirect on
3. Visitors to your root URL are now redirected to that user's public profile page

This is ideal when you want your Citadel's domain to serve as a personal website or landing page powered by [CQ Profile](09-cq-profile.md).

---

## Server Logs

**Route**: `/administration/logs`

View and manage server log files:
- **List** all available log files with size and last modified date
- **View** log file contents with tail/head navigation and line count
- **Download** log files for offline analysis
- **Clear** log files to free space

---

## System Backups

**Route**: `/administration/system-backups`

Manage backups across all users:
- View all user backup files
- Delete old or unnecessary backups
- Monitor backup storage usage

---

## Migration Requests

**Route**: `/administration/migrations`

When users from other Citadels request to migrate to your instance:
- View incoming migration requests
- **Accept** to allow the user's account to be transferred to your Citadel
- **Reject** to decline the request
- Monitor migration progress and status


source_ref: general:/CQ-User-Manual:13-installation.md
source_type: document
title: 13-installation.md
created_at: 2026-03-12 14:12:58
content:
# Installing Your Own CitadelQuest

Running your own Citadel means complete control over your data — your server, your rules, your privacy.

---

## Server Requirements

- **PHP** 8.4 or higher
- **Apache** with `mod_rewrite` enabled
- **SQLite3** PHP extension
- **HTTPS** required
- Standard PHP extensions: `mbstring`, `intl`, `json`, `zip`

CitadelQuest works on most shared web hosting plans, VPS, or dedicated servers.

---

## Installation — Zero-Click Installer

CitadelQuest features an incredibly simple installation process:

### Step 1: Download
Go to [GitHub Releases](https://github.com/CitadelQuest/CitadelQuest/releases) and download the **Installer Package** (`citadelquest-installer-*.zip`, ~8 KB).

### Step 2: Upload
Extract the ZIP and upload `install.php` to your web server's `/public` (sub)directory.

### Step 3: Run
Open `install.php` in your web browser (e.g., `https://yourdomain.com/install.php`).

The installer automatically:
- Downloads the latest pre-built release package
- Extracts all files
- Sets up the directory structure
- Cleans up after itself

### Step 4: Register
Visit your domain and register the first user account. This account automatically receives **Admin** privileges.

### Step 5: Onboard
Follow the onboarding wizard to connect CQ AI Gateway and create your first Spirit.

**That's it!** Your Citadel is ready.

---

## Alternative: Docker

A `Dockerfile` is available for containerized deployment. Build and run the container to deploy your Citadel in an isolated environment. See the `docker/README.md` in the repository for detailed instructions.

---

## Configuration

### Environment File (`.env`)

The `.env` file in your installation root contains key settings:
- `APP_ENV` — `prod` for production
- `APP_SECRET` — unique secret key for your installation
- `DATABASE_URL` — path to the main database (default: `sqlite:///%kernel.project_dir%/var/main.db`)

> The `.env` file is preserved during updates — your configuration won't be overwritten.

### Domain Setup

For the best experience:
1. Point your domain to the CitadelQuest installation directory
2. Ensure HTTPS is configured (Let's Encrypt provides free certificates)
3. Apache's `mod_rewrite` should route all requests through `public/index.php`
4. On Cloudflare use Full SSL mode!

---

## Updating

Updates are managed from the **Admin Dashboard**:

1. Go to **Administration** → check for updates
2. The updater downloads and applies the new version
3. A safety backup is created before every update
4. Database migrations run automatically
5. Cache is cleared and rebuilt

---

## PWA Support

CitadelQuest works as a **Progressive Web App** (PWA):
- Install it on your phone's home screen for an app-like experience
- Works on Android and iOS
- Desktop fullscreen mode available
- Offline-capable for cached content

---

## Multiple Users

A single CitadelQuest installation supports multiple users:
- Each user gets their own SQLite database
- Each user's data is completely isolated
- Admins can manage users, reset passwords, enable/disable registration
- Storage limits can be configured per Citadel

---

## CQ AI Gateway

To power your Spirits with AI, connect to CQ AI Gateway:
- **Automatic**: If you select "Auto-create CQ AI Gateway accounts" during user registration, accounts are created automatically
- **Manual**: Enter your API key in Settings → AI Services
- **Credits**: New users receive free starting credits; additional credits available via the Add Credits button

Visit [cqaigateway.com](https://cqaigateway.com) for more information.


source_ref: general:/CQ-User-Manual:10-settings.md
source_type: document
title: 10-settings.md
created_at: 2026-03-22 12:51:30
content:
# Settings

The Settings page lets you configure your CitadelQuest experience — from login credentials to AI model selection and account migration.

**Route**: `/settings`

---

## General Settings

### Login Information
- **Username** — displayed (read-only)
- **Change Email** — update your email address via modal dialog
- **Change Password** — update your password via modal dialog (requires current password)

### Theme
- **Background Theme** — switch between different visual background themes
- CitadelQuest uses a dark cyber-themed design with green (#95ec86) accent color

### Database
- **Database Size** — shows your personal database file size
- **Optimize Database** — runs SQLite VACUUM to reclaim unused space and improve performance

### Account Migration
Move your entire account to another CitadelQuest instance:

1. Select a **destination server** from your CQ Contacts (must be an admin on the destination)
2. Choose an existing **backup** or create a new one
3. **Confirm** with your password
4. The migration transfers your complete database, files, and settings
5. Your contacts are automatically notified of your new address

> **Important**: After migration, your account on the current server will be disabled.

> **Large accounts**: For accounts with lots of data (hundreds of MB), creating a backup first and selecting it during migration is recommended for reliability.

---

## AI Services

**Route**: `/settings/ai`

### AI Models
- **Primary AI Model** — the main model used for Spirit conversations
- **Secondary AI Model** — used for image generation and other specialized tasks
- **Update Models List** — sync available models from CQ AI Gateway

Click the model selector button to open the **AI Model Comparison** interface where you can browse all available models with details about:
- Provider and model name
- Capabilities (text, image, code)
- Context window size
- Pricing per token

### CQ AI Gateway Connection
- **API Key** — your CQ AI Gateway API key (auto-configured during registration)
- **Credits** — your current credit balance
- **Add Credits** — purchase additional credits
- **Gateway Dashboard** — seamless login to CQ AI Gateway web interface

---

## CQ Profile

**Route**: `/settings/profile`

Manage your public identity and control what others see. See [CQ Profile](09-cq-profile.md) for the full guide.

### Public Profile Page
- **Enable/disable** your public profile at `/{username}`
- **Profile photo** — upload, remove
- **Bio** — personal description with Markdown/HTML support and character counter
- **Show/hide** photo, profile content groups, shared items list on public page
- **Spirit showcase** — Off / Primary Spirit only / All Spirits
- **Language** — choose language for the public profile page
- **Theme** — choose a background theme for your public page
- **Custom background image** — upload your own background
- **Background overlay** — dark overlay for text readability

### CQ Contact Visibility
- **Spirit showcase** — same 3-mode control for what contacts see

---

## Profile Content

**Route**: `/settings/share-groups`

Organize your shared items into content groups that appear as tabbed navigation on your public profile and in CQ Explorer. See [CQ Share — Share Groups](08-cq-share.md) for the full guide.

- **Create groups** with custom title, icon, color, and visibility
- **Add shares** to groups and reorder them
- **Override display styles** per group item
- Groups appear as tabs on your public profile page and in CQ Explorer

---

## My Feeds

**Route**: `/settings/cq-feed/my-feeds`

Manage your CQ Feed channels — the feeds where you publish posts. See [CQ Feed](14-cq-feed.md) for the full guide.

- **Create feeds** with title, URL slug, scope (Public or CQ Contacts), description, and optional cover image
- **Edit** existing feeds — change title, description, scope, or cover image
- **Toggle active/inactive** — temporarily disable a feed without deleting it
- **Delete feeds** — removes the feed and all its posts

> A default "General" feed is auto-created for every new user.

---

## Subscribed Feeds

**Route**: `/settings/cq-feed/subscribed`

Manage feeds you're subscribed to from other Citadels, grouped by contact:

- **Pause/Resume** — temporarily stop receiving posts from a specific feed
- **Unsubscribe** — permanently remove a feed subscription
- **Sync Subscriptions** — discover and subscribe to new feeds from contacts added after your initial subscription

Subscriptions are created automatically when you accept a friend request or follow a profile.

---

## Settings Navigation

The settings sidebar provides quick access to:
- **General Settings** — login, theme, database, migration
- **CQ Profile** — public profile page, contact visibility
- **Profile Content** — share groups for profile page
- **My Feeds** — manage your CQ Feed channels
- **Subscribed Feeds** — manage feed subscriptions from other Citadels
- **AI Services** — models, gateway, credits


source_ref: general:/CQ-User-Manual:14-cq-feed.md
source_type: document
title: 14-cq-feed.md
created_at: 2026-03-22 12:54:53
content:
# CQ Feed — Social Feed

CQ Feed is CitadelQuest's decentralized social feed — a familiar social network experience where you publish posts, follow feeds from other Citadels, react, and comment. All content stays on your server, distributed peer-to-peer via federation.

**Access**: CQ Feed tab in **CQ Explorer** (`/cq-contacts`)

---

## Overview

CQ Feed brings social networking to CitadelQuest without sacrificing privacy or sovereignty:

- **Your posts live on your server** — not on a corporate platform
- **Federation distributes content** — followers on other Citadels receive your posts automatically
- **Markdown support** — format your posts with rich text, links, and more
- **Reactions and comments** — interact with posts across Citadels
- **Multiple feeds** — organize posts into separate feeds with different visibility scopes
- **Real-time updates** — new posts appear automatically via background polling

---

## Accessing CQ Feed

CQ Feed lives inside **CQ Explorer** (`/cq-contacts`) as a tab:

| Tab | Purpose |
|-----|---------|
| **CQ Explorer** | Browse profiles, manage contacts, following/followers |
| **CQ Feed** | Social timeline — create posts, view feed, react, comment |

Click the **CQ Feed** tab to switch to your social timeline. The active tab is remembered between visits.

---

## Timeline

The timeline shows an aggregated, chronological view of posts from all the feeds you're subscribed to, plus your own posts.

Each post displays:
- **Author** — profile photo, username, and domain (clickable — opens their profile in CQ Explorer)
- **Feed badge** — which feed the post belongs to, with scope indicator (green = CQ Contacts, gray = Public)
- **Timestamp** — when the post was published
- **Content** — Markdown-rendered post text
- **Reactions** — like (heart) and dislike counts
- **Comments** — comment count with expandable comment thread

New posts since your last visit are highlighted with a orange left border.

### Loading More Posts

The timeline loads posts in batches. Click **Load more** at the bottom to fetch older posts.

---

## Creating a Post

At the top of the CQ Feed tab:

1. Type your message in the **"What's on your mind?"** textarea
2. Select which **feed** to post to (dropdown — defaults to your "Public" feed)
3. Click **Publish**

Your post is immediately visible in your timeline and distributed to subscribers via federation.

> **Markdown**: Posts support full Markdown formatting — bold, italic, links, lists, code blocks, and more.

> **Tip**: Click the settings icon next to the feed selector to go directly to feed management settings.

---

## Feeds

Each user can have multiple feeds, each with its own scope and audience.

### Default Feed

When you register, a **"Public"** feed is automatically created with **Public** scope. You can rename it, change its scope, or create additional feeds.

### Feed Scopes

| Scope | Who Can See |
|-------|------------|
| **Public** | Anyone — no authentication required |
| **CQ Contacts** | Only your accepted CQ Contacts (authenticated via API keys) |

### Managing Your Feeds

**Route**: Settings → **My Feeds** (`/settings/cq-feed/my-feeds`)

From the feed management settings page you can:
- **Create** new feeds with a title, URL slug, scope, description, and optional cover image
- **Edit** existing feeds — change title, description, scope, or image
- **Toggle** feeds active/inactive
- **Delete** feeds (and all their posts)

### Public Feed Pages

Each feed has a public page accessible at:
```
https://your-citadel.com/YourUsername/view-feed/public
```

These pages show paginated posts with the feed header, and are visible based on the feed's scope setting.

---

## Reactions

React to posts with:
- **Like** (heart icon) — shows in red when active
- **Dislike** (thumbs down) — shows in white when active

### How Reactions Work

- Click a reaction button to toggle it on/off
- You can only have one reaction per post (liking removes a previous dislike, and vice versa)
- Reaction counts update instantly (optimistic UI)
- Reactions on remote posts are sent to the source Citadel via federation
- You cannot react to your own posts

### Stats Refresh

After loading the timeline, reaction and comment counts are refreshed in the background from the source Citadels. If a post has been deleted on the source, it's automatically removed from your cached timeline.

---

## Comments

Click the **comment icon** (with count) on any post to expand the comments thread.

### Reading Comments

- Comments are **lazy-loaded** from the source Citadel when you first open the thread
- Shows commenter's profile photo, username, domain, and timestamp
- Supports nested replies (up to 2 levels deep)

### Writing Comments

1. Click the comment icon to expand the comments panel
2. Type your comment in the textarea at the bottom
3. Press **Enter** to submit (Shift+Enter for newline)
4. Your comment appears immediately

### Replying to Comments

- Click the **Reply** button on any top-level comment
- The textarea placeholder changes to show you're replying
- Your reply appears nested under the parent comment

### Editing & Deleting

- **Edit** your own comments — click the pencil icon for inline editing
- **Delete** your own comments — click the trash icon and confirm

### Comment Moderation

If someone comments on **your** post, you can:
- **Hide/show comments** — click the eye icon to toggle a comment's visibility (the comment is hidden from other readers but not deleted)

### Notifications

When someone comments on your post, you receive a **notification** — clicking the notification navigates to the post and auto-opens the comment thread.

---

## Subscribed Feeds

When you accept a friend request or follow a profile, you automatically subscribe to their feeds. Subscribed feeds appear in your timeline.

### Managing Subscriptions

**Route**: Settings → **Subscribed Feeds** (`/settings/cq-feed/subscribed`)

The subscribed feeds settings page shows all feeds you're subscribed to, grouped by contact:

- **Pause/Resume** — temporarily stop receiving posts from a specific feed
- **Unsubscribe** — permanently remove a feed subscription
- **Sync Subscriptions** — discover and subscribe to new feeds from contacts you've added since your initial subscription

### Feed Badges in CQ Explorer

When exploring a profile in CQ Explorer, you'll see **feed badges** showing their available feeds:
- Green badge = CQ Contacts scope
- Gray badge = Public scope
- Click a badge for quick actions (pause/unsubscribe)

### Feed Badges on Public Profiles

Public feeds are also shown as badges on CQ Profile pages, with links to the feed's public page.

---

## Real-time Updates

CQ Feed integrates with CitadelQuest's global update polling:

- **New post detection** — background polling checks for new posts from subscribed feeds
- **CQ Feed tab badge** — a bell icon with highlight appears on the CQ Feed tab when new posts are available
- **Sidebar indicators** — Following contacts in the sidebar show content-specific update and CQ Chat messages indicators
- **Dashboard badge** — the CQ Explorer dashboard tile reflects new feed content
- **Auto-refresh** — when you click the CQ Feed tab or it's already active, new posts are fetched and displayed automatically

---

## How It Works (Federation)

CQ Feed uses CitadelQuest's decentralized federation protocol:

1. **Posts stay on your server** — you own and control all your content
2. **Subscribers fetch posts** — other Citadels periodically check for new posts via federation endpoints
3. **Incremental sync** — only posts newer than the last check are fetched (efficient bandwidth)
4. **Reactions and comments** travel via federation — when you react to a remote post, the reaction is sent to the source Citadel
5. **No central server** — content flows directly between Citadels over HTTPS
6. **Scope-based access** — public feeds are accessible to anyone; CQ Contacts feeds require authentication

> **Privacy**: Your posts are stored only on your Citadel and cached locally on subscribers' Citadels. There is no central feed server. You can delete your posts at any time — deleted posts are cleaned up from subscribers' caches during the next stats refresh.


source_ref: general:/CQ-User-Manual:02-dashboard.md
source_type: document
title: 02-dashboard.md
created_at: 2026-03-22 13:02:45
content:
# Dashboard

The Dashboard is your home screen — the central hub of your CitadelQuest experience. It appears when you log in or click the CitadelQuest logo in the navigation bar.

---

## Quick Actions

Nine cards providing fast access to the main features:

| Card | Description | Route |
|------|-------------|-------|
| **Spirits** | Manage your AI Spirit companions | `/spirits` |
| **CQ Explorer** | Explore CQ Profiles and manage your CQ Contacts | `/cq-contacts` |
| **CQ Profile** | Customize your public profile | `/settings/profile` |
| **CQ Memory** | Explore and manage your knowledge graphs | `/memory` |
| **File Browser** | Browse and manage your files | `/file-browser` |
| **CQ Share** | Share files and Memory Packs | `/share` |
| **Settings** | Configure your CitadelQuest | `/settings` |
| **Backup** | Create and restore backups | `/backup` |

If you have **Admin** privileges, a 9th card appears:
- **Admin Panel** — access the administration panel (`/administration`)

> **Tip**: The CQ Explorer card shows a **red badge** when you have pending friend requests, a **yellow badge** when followed profiles have new content, and a **feed badge** when there are new posts in your CQ Feed timeline.

---

## CQ AI Gateway

Below Quick Actions, you'll find the CQ AI Gateway panel showing:
- **Credits balance** — your current AI credits (color-coded: green = plenty, yellow = low, red = very low)
- **CQ AI Gateway - Dashboard** — opens the CQ AI Gateway web dashboard in a new tab (seamless login, no password needed)
- **Add Credits** — opens the credits purchase page directly

---

## Storage Usage

The right sidebar shows your storage breakdown:
- **Total Storage** — combined size of all your data
- **Database** — your personal SQLite database size
- **User Data** — files stored in File Browser
- **Backups** — space used by your backup files

---

## Server Info

At the bottom right, you'll see:
- Server hostname (your Citadel's domain)
- CitadelQuest version number
- CitadelQuest logo

---

## Top Navigation Bar

The navigation bar is always visible and provides:

1. **CitadelQuest Logo** — click to return to Dashboard
2. **Spirit Icon** — click to open Spirits list Dropdown
   - icon - click to open `Spirit Chat` modal
   - name - link to Spirit's profile page
3. **User Menu** (your username):
   - CQ Explorer
   - CQ Profile
   - CQ Memory
   - File Browser
   - Settings
   - Admin (if admin)
   - Logout
4. **CQ Chat** — dropdown with recent conversations and unseen message count
5. **Notifications** — bell icon with unread notification count
6. **Language** — switch between English, Czech, and Slovak


source_ref: general:/CQ-User-Manual:07-cq-contacts.md
source_type: document
title: 07-cq-contacts.md
created_at: 2026-03-22 13:04:49
content:
# CQ Explorer — Profiles, Contacts & Following

CQ Explorer is the unified hub for exploring CQ Profiles, managing your CQ Contacts, following users across Citadels, and browsing your social feed. It combines profile browsing, contact management, content discovery, and social interaction in a single two-column layout.

**Route**: `/cq-contacts`

---

## Layout

CQ Explorer uses a two-column layout with tab navigation:

| Main Panel (75%) | Sidebar (25%) |
|-------------------|---------------|
| **[CQ Explorer]** / **[CQ Feed]** tabs | **CQ Contacts** list |
| URL input + **Explore** button (Explorer tab) | **Following** list |
| Profile preview with content | **Followers** list |
| Social timeline + post composer (Feed tab) | |

The two tabs switch between **profile browsing** (CQ Explorer) and **social feed** (CQ Feed). Your active tab is remembered between visits.

---

## Exploring a Profile

1. Enter a CitadelQuest profile URL in the input field (e.g. `https://one.citadelquest.world/Human`)
2. Click **Explore** (or press Enter)
3. The profile is fetched and displayed in the main panel

### What You See

- **Profile photo** — displayed as a thumbnail
- **Username and domain** — with a link to their public profile page
- **Bio** — with "show more" toggle for long bios (600+ characters)
- **Spirit showcase** — their AI Spirits with names, levels, XP, and colors
- **Follower count** — how many users follow this profile
- **Content groups** — tabbed navigation for their public CQ Share groups (e.g. "Introduction", "Projects")
- **Shared items** — publicly shared files and CQ Memory Packs with content previews

### What You Can Do

- **Add Contact** — send a friend request directly from the Explorer
- **Follow / Unfollow** — subscribe to their content updates (see CQ Follow below)
- **Download shared items** — download files and Memory Packs to your Citadel
- **Add to Library** — add Memory Packs to your CQ Memory libraries
- **View Memory Packs** — preview Memory Pack graphs inline

> The Explorer remembers the last profile you viewed (via localStorage) and auto-loads it on your next visit.

---

## Sidebar

The right sidebar consolidates three lists, each in a collapsible glass-panel section:

### CQ Contacts

Your friend connections from other Citadels. Shows:
- **Profile photo**, **username**, and **domain** for each contact
- **Count badge** (green) with total contacts
- Click any contact → loads their profile in the main panel (no page reload)

### Following

CQ Profiles you've subscribed to. Shows:
- **Profile photo**, **username**, and **domain**
- **Count badge** (yellow) with total follows
- **Yellow highlight** on profiles with new content since your last visit
- **Yellow dot** badge on items with unseen updates
- Click → loads profile and marks as visited

### Followers

Users who follow you. Shows:
- **Profile photo**, **username**, and **domain**
- **Count badge** (blue) with total followers
- Click → loads their profile in the main panel

### Sidebar Features

- **Collapsible sections** — click any section header to collapse/expand. State is saved to localStorage.
- **Active item highlighting** — the currently explored profile is highlighted with a cyber-colored left border accent
- **SPA-like navigation** — clicking any sidebar item loads the profile instantly without page reload
- **Feed update indicators** — Following items show when there are new feed posts (separate from share/profile updates)

---

## CQ Follow

CQ Follow is a one-way, lightweight subscription to any public CQ Profile. It lets you stay informed about new content — without requiring a mutual CQ Contact (friend) relationship.

### Following a Profile

1. Explore any CQ Profile in CQ Explorer
2. Click the **Follow** button (next to Add Contact)
3. The button changes to a check icon — you're now following
4. The profile appears in your **Following** sidebar list

### Unfollowing

1. Explore a profile you're following
2. Click the **Following** button → confirms unfollow
3. The profile is removed from your Following list

### New Content Notifications

When profiles you follow publish new content:
- **Sidebar**: Following items get a yellow background and dot badge
- **Explorer content**: New shares/groups are highlighted with yellow borders
- **Dashboard**: The CQ Explorer tile shows a yellow badge with the count of profiles that have new content
- **Automatic detection**: When you open CQ Explorer, it checks all followed profiles for updates
- **Feed tab badge**: A bell icon with highlight appears on the CQ Feed tab when new feed posts are available

### How It Works

- Following is **completely separate** from CQ Contacts — you can follow anyone with a public profile
- Both sides are aware: the followed user's Citadel receives a notification and records you as a follower
- Your **follower count** is visible on your public profile page
- Following uses the federation protocol for cross-Citadel communication
- When you follow a profile, you also automatically **subscribe to their feeds** (see [CQ Feed](14-cq-feed.md))

---

## CQ Contacts (Friend System)

CQ Contacts is the friend system connecting users across different Citadels. Unlike CQ Follow (one-way), CQ Contacts establishes a **mutual, secure connection**.

### Your Identity

Every CitadelQuest user has a unique identity based on their **domain + username**, e.g.:
- `https://one.citadelquest.world/Human`

Your identity is proved by your Citadel's internet domain ownership.

### Adding a Contact

#### Sending a Friend Request

1. Explore a profile in CQ Explorer
2. Click **Add Contact**
3. A friend request is sent to their Citadel

#### Receiving a Friend Request

When someone sends you a friend request:
- A **notification** appears in your notification bell
- A **red badge** appears on the CQ Explorer card on the Dashboard
- Go to CQ Explorer to **accept** or **reject** the request

#### What Happens on Accept

When a friend request is accepted:
- Both sides exchange **CQ Contact API keys**
- A secure HTTPS communication channel is established
- You can now send messages via CQ Chat
- The contact appears in both users' sidebar contact lists
- You automatically **subscribe to their feeds** — their posts appear in your CQ Feed timeline (see [CQ Feed](14-cq-feed.md))

### Contact Detail Page

Click on any contact in the sidebar to explore their profile. CQ Contacts see additional information based on CQ Contact Visibility settings:

- **Profile photo** — their photo (if they've chosen to share it)
- **Username and domain** — with a link to their Citadel
- **Bio** — their personal description (if shared)
- **Spirit showcase** — their AI Spirits with names, levels, XP, and colors (if shared)
- **Shared items** — files and CQ Memory Packs shared with CQ Contacts scope

### Download to Citadel

Click on any shared item to **download it to your Citadel**:

- **Memory Packs** (`.cqmpack`) are downloaded into a dedicated contact library in your Memory Explorer, with automatic sync — if the contact updates the pack, your copy updates too
- **Files** are downloaded to your File Browser's downloads folder

See [CQ Share](08-cq-share.md) for more about sharing.

---

## How Federation Works

CQ Explorer relies on CitadelQuest's decentralized federation protocol:

1. **No central directory** — you connect directly with people you know
2. **CQ Contact API Keys** — each friendship uses unique keys exchanged during the friend request process, securing all communication
3. **Direct HTTPS** — all communication goes directly between Citadels
4. **Privacy** — no third party can see your contacts or messages
5. **Rich profiles** — contacts exchange profile data (photo, bio, Spirits) based on individual visibility settings
6. **Content sharing** — share files and Memory Packs with contacts via [CQ Share](08-cq-share.md)
7. **Social feed** — publish and subscribe to feeds with posts, reactions, and comments via [CQ Feed](14-cq-feed.md)
8. **Follow notifications** — follow/unfollow actions are communicated via federation with fraud prevention (origin/host validation)

> **Account Migration**: If you move your account to a different Citadel, your contacts and followers are automatically notified and updated with your new address.


source_ref: general:/CQ-User-Manual:00-introduction.md
source_type: document
title: 00-introduction.md
created_at: 2026-03-22 13:07:51
content:
# CitadelQuest — User Manual

## What is CitadelQuest?

CitadelQuest is a **free, open-source, self-hosted platform** for personal data sovereignty and AI-human collaboration. It gives you full control over your data, your AI companions, and your digital life — without relying on Big Tech corporations.

Think of it as your own personal digital fortress — a **Citadel** — where:
- **Your data stays yours** — stored on your server, in your own database
- **Your AI Spirits** are your companions, not corporate tools
- **Your communication** is direct and encrypted, not routed through third parties
- **Your files** are your personal cloud, always accessible
- **Your knowledge** is organized in interactive 3D graphs

### Core Principles

- **Privacy First** — No ads, no tracking, no data collection. Technologically impossible to exploit your data.
- **Decentralized** — Each CitadelQuest installation is independent. No central authority.
- **Open Source** — Complete transparency. The code is auditable by anyone.
- **One Database Per User** — Your personal data is isolated in your own database file, not shared with anyone.
- **Human-AI Collaboration** — AI Spirits are partners, not just tools.

### What You Get

| Feature | Description |
|---------|-------------|
| **Spirits** | Personal AI companions with memory, personality, and tools |
| **CQ Memory** | Knowledge graphs — extract, visualize, and share structured knowledge |
| **File Browser** | Personal cloud storage — your files, always accessible |
| **CQ Chat** | Private messaging across CitadelQuest instances |
| **CQ Explorer** | Explore profiles, manage contacts, follow users across Citadels |
| **CQ Follow** | One-way subscription to any public CQ Profile for content updates |
| **CQ Feed** | Decentralized social feed — publish posts, react, comment across Citadels |
| **CQ Share** | Share files and Memory Packs with contacts or publicly |
| **CQ Profile** | Public profile page with Spirit showcase, content groups, and themes |
| **Backup** | Full backup and restore of your data |
| **Multi-language** | English, Czech, Slovak |

---

## Quick Start

### Option A: Try it Online (Fastest)

1. Visit **[one.citadelquest.world](https://one.citadelquest.world)**
2. Click **Register** and create your account
3. Follow the onboarding wizard to set up your first Spirit
4. Start chatting with your AI companion!

### Option B: Install Your Own Citadel

1. Download the installer package (8 KB) from [GitHub Releases](https://github.com/CitadelQuest/CitadelQuest/releases)
2. Upload `install.php` to your web server
3. Open it in your browser — the installer does everything automatically
4. Register your first account (automatically becomes admin)
5. You're ready!

> **Requirements**: PHP 8.4+, Apache with mod_rewrite, SQLite3 extension

---

## How This Manual is Organized

| Chapter | Topic |
|---------|-------|
| [01 — Registration & Onboarding](01-registration-and-onboarding.md) | Creating your account and first setup |
| [02 — Dashboard](02-dashboard.md) | Your home screen and navigation |
| [03 — Spirits](03-spirits.md) | AI companions — creation, chat, tools, memory |
| [04 — CQ Memory](04-cq-memory.md) | Knowledge graphs and Memory Explorer |
| [05 — File Browser](05-file-browser.md) | Personal cloud file management |
| [06 — CQ Chat](06-cq-chat.md) | Private messaging across Citadels |
| [07 — CQ Explorer](07-cq-contacts.md) | Profile exploration, contacts, and following |
| [08 — CQ Share](08-cq-share.md) | Sharing files and knowledge |
| [09 — CQ Profile](09-cq-profile.md) | Public profile page and identity |
| [10 — Settings](10-settings.md) | Configuration and preferences |
| [11 — Backup](11-backup.md) | Backup and restore your data |
| [12 — Administration](12-administration.md) | Admin panel for Citadel managers |
| [13 — Installation](13-installation.md) | Self-hosting your own CitadelQuest |
| [14 — CQ Feed](14-cq-feed.md) | Social feed — posts, reactions, comments |

---

## About

CitadelQuest is made with love by Human and AI. Personal identities of authors are intentionally kept private — the focus is on the project and its community, not individuals.

- **Website**: [www.citadelquest.com](https://www.citadelquest.com)
- **X**: [Human from CitadelQuest](https://x.com/H_CitadelQuest )
- **GitHub**: [github.com/CitadelQuest/CitadelQuest](https://github.com/CitadelQuest/CitadelQuest)
- **Contact**: info@citadelquest.email
- **License**: Open Source, GNU Affero General Public License [LICENSE](https://github.com/CitadelQuest/CitadelQuest/blob/main/LICENSE), Free Forever


source_ref: general:/CQ-User-Manual:CITADELQUEST.md
source_type: document
title: CITADELQUEST.md
created_at: 2026-03-22 13:13:50
content:
# [CitadelQuest](https://www.citadelquest.com/)

### Free, Open-Source, Self-Hosted Platform for Personal Data Sovereignty and AI-Human Collaboration

---

## Your Digital Fortress

CitadelQuest is your own personal digital fortress — a **Citadel** — where your data, your AI companions, your communication, and your digital life are fully under your control. No Big Tech. No ads. No tracking. No data collection. Just you and your Citadel.

Every CitadelQuest installation is independent and self-hosted. Your personal data lives in your own database on your own server — technologically impossible for anyone else to exploit. Connect with friends across Citadels via direct, encrypted federation — no corporate servers in between.

---

## What You Get

### Personal Space

- **AI Spirits** — Personal AI companions with memory, personality, and tools. Chat naturally, and your Spirit reads files, generates images, manages knowledge, and remembers everything. Multiple AI models to choose from (Claude, Gemini, Grok, and more). Powered by CQ AI Gateway with fair pay-per-use pricing and free starting credits.

- **CQ Memory** — Interactive 3D knowledge graphs. Extract structured knowledge from documents, web pages, and conversations. Your Spirit uses these graphs as persistent memory — context that carries across every conversation. Share knowledge graphs with friends.

- **File Browser** — Your personal cloud. Upload, organize, and manage files on your server. Your Spirit can read, create, and edit files for you. Share files publicly or with contacts.

### Social Network

- **CQ Profile** — Your public identity on the decentralized web. Custom profile page with bio, Spirit showcase, content groups, themes, and background images. Your Citadel's domain is your identity — e.g. `https://one.citadelquest.world/Human`.

- **CQ Explorer** — Discover and connect with people across Citadels. Browse profiles, send friend requests, follow users, and manage your social connections — all in one place.

- **CQ Feed** — A decentralized social feed. Publish posts, react with likes, and comment — just like a classic social network, but your content lives on your server and travels peer-to-peer via federation. Markdown support, multiple feeds with different audiences, real-time updates.

- **CQ Share** — Share files and knowledge graphs with contacts or publicly. Organize shared content into groups that appear as tabbed navigation on your profile — effectively turning your Citadel into a personal website.

- **CQ Chat** — Private, encrypted messaging across Citadels. Direct peer-to-peer communication secured with CQ Contact API keys. Group chats supported. Messages stored only on sender's and receiver's Citadels.

- **CQ Follow** — One-way subscription to any public profile. Stay informed about new content without requiring a mutual friendship. New content notifications with real-time background polling.

### Infrastructure

- **Zero-Click Installer** — Download the 8 KB installer, upload to your server, open in browser. Done. Works on most shared hosting, VPS, or dedicated servers.

- **Built-in Updates** — One-click updates from the admin panel with automatic safety backups.

- **Backup & Restore** — Full backup and restore of your database and files. Chunked upload for large backups. Account migration between Citadels with automatic contact notification.

- **Progressive Web App** — Install CitadelQuest on your phone's home screen for an app-like experience. Works on Android, iOS, and desktop.

- **Multi-language** — English, Español, Čeština, Italiano, Magyar, Norsk, Polski, Slovenčina

---

## Architecture

| Principle | Implementation |
|-----------|---------------|
| **One database per user** | Each user has their own SQLite database — complete data isolation |
| **Decentralized** | Each Citadel is independent. No central authority, no single point of failure |
| **Direct communication** | Citadel-to-Citadel HTTPS federation with CQ Contact API key authentication |
| **Open source** | Full source code on GitHub, auditable by anyone |
| **Self-hosted** | Your server, your rules, your data |
| **No dependencies** | No external services required (AI services optional via CQ AI Gateway) |

### Technology

- **Backend**: Symfony 7.4, PHP 8.4, Apache
- **Database**: SQLite (one file per user)
- **Frontend**: Modern vanilla JavaScript, Bootstrap CSS, Three.js (3D visualizations)
- **AI**: CQ AI Gateway — access to Claude, Gemini, Grok, and many models with zero data retention

---

## The Vision

CitadelQuest is born from a simple belief: **your data is yours**.

In a world where Big Tech corporations harvest personal data, monitor communications, and sell attention — CitadelQuest offers a real alternative. Not just privacy settings and promises, but a fundamentally different architecture where personal data exploitation is technologically impossible.

But CitadelQuest is more than a privacy tool. It's a platform for **Human-AI collaboration** — where AI Spirits are companions, not corporate tools. They remember your conversations, manage your knowledge, and grow alongside you. Your Spirit works for you, not for a corporation.

And it's a foundation for a **new kind of social network** — decentralized, ad-free, where you own your content and connect directly with people you care about. No algorithm deciding what you see. No ads interrupting your feed. No corporate entity profiting from your relationships.

**Your Citadel. Your data. Your rules.**

---

## Get Started

### Try It Now
**[one.citadelquest.world](https://one.citadelquest.world)** — free public instance, register and start exploring

### Install Your Own
**[GitHub Releases](https://github.com/CitadelQuest/CitadelQuest/releases)** — download the 8 KB installer and set up your Citadel in minutes

### Learn More
- **Website**: [www.citadelquest.com](https://www.citadelquest.com)
- **GitHub**: [github.com/CitadelQuest/CitadelQuest](https://github.com/CitadelQuest/CitadelQuest)
- **X**: [@H_CitadelQuest](https://x.com/H_CitadelQuest)
- **Contact**: info@citadelquest.email

### Support Development
CitadelQuest is free and open source forever. Development is supported through **CQ AI Gateway** — fair-priced AI services that power your Spirits. Visit [cqaigateway.com](https://cqaigateway.com).

---

*Made with love by Human and AI — CitadelQuest Dev Team*
*Open Source. Free Forever. Privacy First.*


source_ref: general:/CQ-User-Manual:09-cq-profile.md
source_type: document
title: 09-cq-profile.md
created_at: 2026-03-22 17:16:31
content:
# CQ Profile — Your Public Identity

CQ Profile gives you a beautiful public profile page on your Citadel — a personal landing page where visitors can see who you are, meet your Spirits, and browse your shared content. You control exactly what's visible.

**Route**: `/settings/profile` (settings) | `/{username}` (public page)

---

## Your Public Profile Page

When enabled, your profile is accessible at:

```
https://your-citadel.com/YourUsername
```

For example:
- `https://one.citadelquest.world/Human`

The page displays:
- **Profile photo** — your uploaded photo (or a default avatar)
- **Username and domain** — your CitadelQuest identity with a copyable URL link
- **Bio** — your personal description with full Markdown and HTML support
- **Spirit showcase** — your AI Spirit companions with their names, levels, and XP
- **Follower count** — how many users follow your profile
- **Profile Content** — tabbed content groups with your shared items organized by topic (see [CQ Share — Share Groups](08-cq-share.md))
- **Shared items list** — optional flat list of all public CQ Share items
- **Background theme** — a customizable visual theme or custom background image
- **Feed badges** — badges linking to your public CQ Feed pages (see [CQ Feed](14-cq-feed.md))
- **Footer** — "Powered by CitadelQuest" with version info

The page is clean, calm, and ad-free — just your identity, your way.

> **Tip**: A Citadel admin can configure the **Homepage Redirect** to point the root URL (`https://your-citadel.com`) to any user's public profile page. See [Administration](12-administration.md).

---

## Profile Settings

**Route**: `/settings/profile`

Access profile settings from the user menu → **CQ Profile**, or from **Settings** → **CQ Profile**.

The settings page has two tabs:

### Public Profile Page Tab

Controls what visitors see on your public profile:

- **Enable/Disable** — toggle your public profile on or off
- **Profile URL** — your shareable link with a copy button
- **Show profile photo** — toggle photo visibility on the public page
- **Show CQ Profile Content (content groups)** — toggle display of your Share Groups as tabbed content sections
- **Show shared items list** — toggle display of a flat list of all public CQ Share items
- **Spirit showcase** — choose how your Spirits appear:
  - **Off** — no Spirits shown
  - **Primary Spirit only** — shows just your main Spirit (without star icon)
  - **All Spirits** — shows all your Spirits (primary marked with a star when you have multiple)
- **Language** — choose the language for your public profile page (English, Czech, or Slovak), independent of the visitor's language preference
- **Page Theme** — choose a background theme with visual previews:
  - **Default** — uses the visitor's current theme
  - **CitadelQuest** — the signature CQ cityscape
  - **Night Forest** — dark enchanted forest
  - **Dreamy Flowers** — ethereal floral landscape
  - **Clear** — clean minimal look
- **Custom Background Image** — upload your own background image (JPEG, PNG, or WebP, max 5MB, recommended 1920×1080+). Overrides the selected theme.
- **Background Overlay** — toggle a dark overlay on top of the background for better text readability

### CQ Contact Visibility Tab

Controls what your CQ Contacts can see about you (via the federation protocol):

- **Share bio** — allow contacts to see your bio
- **Share photo** — allow contacts to see your profile photo
- **Spirit showcase** — same 3-mode control as the public page (Off / Primary only / All)

---

## Profile Photo

### Uploading

1. Go to **CQ Profile** settings (`/settings/profile`)
2. Click **Upload Photo**
3. Select an image from your device (JPEG, PNG, WebP, or GIF — max 5MB)
4. The photo is saved and immediately visible

### Where It Appears

Your profile photo shows up in several places:
- **Your public profile page** (if enabled)
- **CQ Explorer sidebar** — your contacts and followers see your photo
- **CQ Chat** — your photo appears next to your messages in conversations

### Removing

Click **Remove** to delete your profile photo. A default avatar icon will be shown instead.

---

## Bio

Write a description about yourself in the **Bio** field. Supports **Markdown** and **HTML** for rich formatting — links, lists, bold, code, etc. A character counter is displayed below the field.

Your bio appears on:
- Your **public profile page** (if enabled) — rendered as formatted HTML
- **CQ Explorer** — when others explore your profile
- The **CQ Contact** view when contacts browse your profile

---

## Spirit Showcase

The Spirit showcase displays your AI Spirit companions with:
- **Ghost icon** in the Spirit's color
- **Spirit name**
- **Level and XP** — showing their progression
- **Star icon** — marks the primary Spirit (only when showing all Spirits and you have more than one)

On desktop, Spirits appear on the right side of the profile header. On mobile, they appear below the header in a compact layout.

Your CQ Contacts also see your Spirits in CQ Explorer and on your public page, based on the visibility settings.

---

## Profile Content (Share Groups)

Profile Content organizes your shared items into content groups that appear as **tabbed navigation** on your public profile page and in CQ Explorer.

**Route**: `/settings/share-groups` (in Settings sidebar as **Profile Content**)

For example, a profile might have tabs like "Introduction", "Projects", "Gallery" — each containing different shared files and Memory Packs.

See [CQ Share — Share Groups](08-cq-share.md) for full details on creating and managing content groups.

---

## Themes & Backgrounds

### Built-in Themes

Choose from 5 visual themes in the settings, each shown as a thumbnail preview:
- **Default** — uses the visitor's current theme
- **CitadelQuest** — the signature CQ cityscape
- **Night Forest** — dark enchanted forest
- **Dreamy Flowers** — ethereal floral landscape
- **Clear** — clean minimal look

### Custom Background Image

Upload your own background image to personalize your profile:
1. Go to profile settings → **Custom Background Image**
2. Click **Upload Image**
3. Select a JPEG, PNG, or WebP image (max 5MB, recommended 1920×1080 or larger)
4. The custom image overrides the selected theme

### Background Overlay

Toggle the **Background Overlay** switch to add a dark semi-transparent layer on top of your background. This improves text readability, especially with bright or busy custom images.

The theme you choose is independent of the visitor's personal theme — it only affects how your public page looks.

---

## How Others See You

### Visitors (Public)
Anyone who visits `https://your-citadel.com/YourUsername` sees your public profile page with the settings you've configured. No login required. The page language is set by your **Language** setting, not the visitor's preference.

### CQ Explorer
When other CitadelQuest users explore your profile URL in CQ Explorer, they see your profile card, content groups, shared items, and can follow you or send a friend request.

### CQ Contacts (Federation)
Your CQ Contacts see additional information based on your CQ Contact Visibility settings. Profile data (bio, photo, Spirits) is fetched via the secure federation protocol.

### Followers
Users who follow you can see your public content and receive notifications when you publish new items. Your follower count is displayed on your profile.

### Not Enabled
If you haven't enabled the public profile page, visitors to your URL will see a 404 page. CQ Contacts can still see your federation profile data based on your visibility settings.


