esmyx/diskhub - Codeberg.org

========================================
Diskhub - A Local Alternative to GitHub
========================================
--- Why Diskhub? ---
Honestly, you probably shouldn't use it yet. It's still a work in progress and needs polishing.
However, it's a fun technical challenge: a local tool to visualize and manage your projects
directly from your disk—no Git or SaaS required.
--- Features ---
Diskhub reads files directly from disk (no commits, history, or Git features).
But it still offers:
 * Global statistics:
 - Number of projects, lines of code, files
 - Language breakdown (with percentages)
 - Distribution by status (Idea, Started, Functional, Finished, Archived)
 * Integrated file explorer (per project and global)
 * Ollama Chat integration (local AI chat)
 * Snippets Manager: save, edit, copy, and search your code snippets
 * Per-project statistics (e.g., 52% Go, 47% HTML, 2% CSS)
 * Basic Wiki per project (Markdown support, tables, links, diagrams)
Everything is developed with minimal JavaScript for compatibility with minimal rendering engines.
--- Configuration ---
Diskhub requires two levels of configuration: global and per-project.
[Global Configuration]
Located at the project root, it includes:
 - config.toml: server address, folders to scan, exclusions, Ollama activation
 - languages.json: defines known languages (name, extensions, comment style, etc.)
/!\ Be careful to include "max-workers" in config.toml under the Diskhub section, else it won't
 lunch.
[Per-Project Configuration]
Each project has a `.diskhub/` folder containing:
 - conf.json: project name, author, description, status, tags, external links
 - .ignore: equivalent to .gitignore (excludes files/folders from indexing)
--- Installation ---
1. Clone and build from source (Go required):
 git clone https://codeberg.org/esmyx/diskhub.git
 cd diskhub
 go build -o diskhub .
2. Run the binary:
 ./diskhub
Required files/folders in the same directory:
 - website/ (templates and assets)
 - config.toml (global config)
 - languages.json (language definitions)
 - snippet.db (snippets database)
--- Project Status ---
Diskhub is a personal project in active development.
Core features work, but improvements are ongoing:
 - CLI (commands: stats, search, show, web server link)
 - Snippets Manager (SQL queries, UI)
 - Media support in file explorer
 - Multi-chat with Ollama (persistent chats)
 - Project management from the web interface
 - Wiki improvements (line selection, WYSIWYG, navigation)
--- License ---
MPL2.0 (see LICENSE for details)