{"id":28509541,"url":"https://github.com/pticalin/vaultos","last_synced_at":"2026-05-18T00:32:59.174Z","repository":{"id":296427621,"uuid":"993348022","full_name":"PtiCalin/VaultOs","owner":"PtiCalin","description":"VaultOS is a modular orchestration engine for Obsidian. It manages, compiles, and controls subplugins inside your vault. ","archived":false,"fork":false,"pushed_at":"2025-06-08T23:10:31.000Z","size":112776,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-02T23:35:20.082Z","etag":null,"topics":["cli-tool","digital-garden","digital-gardening","markdown","note-taking","obsidian-plugin","personal-knowledge-base","productivity","structured-notes","typescript","vault-management","vaultos"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PtiCalin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-30T16:25:59.000Z","updated_at":"2025-06-08T23:10:32.000Z","dependencies_parsed_at":"2025-05-30T23:46:34.815Z","dependency_job_id":"d42827d7-0446-4755-9d6b-deedb0363e6a","html_url":"https://github.com/PtiCalin/VaultOs","commit_stats":null,"previous_names":["pticalin/vaultos"],"tags_count":0,"template":false,"template_full_name":"PtiCalin/Awesome-Test-Vault","purl":"pkg:github/PtiCalin/VaultOs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PtiCalin%2FVaultOs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PtiCalin%2FVaultOs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PtiCalin%2FVaultOs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PtiCalin%2FVaultOs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PtiCalin","download_url":"https://codeload.github.com/PtiCalin/VaultOs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PtiCalin%2FVaultOs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33160481,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"ssl_error","status_checked_at":"2026-05-17T22:39:10.741Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli-tool","digital-garden","digital-gardening","markdown","note-taking","obsidian-plugin","personal-knowledge-base","productivity","structured-notes","typescript","vault-management","vaultos"],"created_at":"2025-06-08T22:09:00.061Z","updated_at":"2026-05-18T00:32:59.160Z","avatar_url":"https://github.com/PtiCalin.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧠 VaultOS – Plugin for Obsidian\n\n\u003e VaultOS is a modular plugin orchestration system for [Obsidian](https://obsidian.md) – designed to manage, compile, and control an ecosystem of VaultOS-powered subplugins right from your vault.\n\n[![MIT License](https://img.shields.io/badge/License-MIT-green?style=flat-square)](./LICENSE)\n[![Built with Obsidian](https://img.shields.io/badge/Built%20With-Obsidian-blueviolet?style=flat-square)](https://obsidian.md)\n[![Version](https://img.shields.io/badge/version-0.1.0-blue?style=flat-square)](./manifest.json)\n[![Made by PtiCalin](https://img.shields.io/badge/Made%20by-PtiCalin-8a2be2?style=flat-square)](https://github.com/PtiCalin)\n\n---\n\n### ✨ What is VaultOS?\n\nVaultOS is the beating heart of a modular dev environment inside Obsidian. It watches your plugin folder, auto-registers and compiles VaultOS submodules, and provides an elegant control panel for managing your extended vault OS.\n\nWhether you're building a single subplugin or orchestrating dozens, VaultOS gives you a solid foundation.\n\n---\n\n### 🔧 Core Features\n\n- 🧩 **Auto-detect `vaultos_*` folders** and treat them as managed subplugins\n- ⚙️ **Subplugin scaffolder** to generate all required files and folders\n- 📦 **Converter, Relocator, Validator, and Compilator** utilities to streamline module deployment\n- 💾 **Module metadata cache** for tracking status, structure, and logs\n- 🪟 **VaultOS UI Panel** inside Obsidian's workspace (left or right dock)\n- 📁 **Manifest builder** for compiling subplugin metadata into the main manifest\n- 📑 **Logging system** to track plugin events and actions\n\n---\n\n### 📁 Folder Structure\n\n```\n├── main.ts                # The plugin entry point\n├── src/\n│   ├── core/              # Watcher, logger, cache, UI panel view\n│   ├── modules/           # Module manager and subplugin scaffolder\n│   ├── ops/               # Converter, validator, relocator, compiler\n│   └── templates/         # Handlebars scaffolding templates\n├── dist/                  # Finalized plugin builds and JSON configs\n├── data/                  # Cache, logs, backups\n└── config/                # vaultos_config_extended.json and variants\n```\n\n---\n\n### 📦 Getting Started\n\n```bash\n# 1. Clone this repository anywhere on your machine\ngit clone https://github.com/PtiCalin/vaultos.git\ncd vaultos\n\n# 2. Install dependencies and run tests\n./setup.sh\n#    Run `ENABLE_NET=1 ./setup.sh` if you need to fetch packages from the internet\n\n# 3. Build the plugin\nnpm run build\n\n# 4. Copy `manifest.json` and `main.js` to your vault's\n#    `.obsidian/plugins/vaultos/` folder\n```\n\nAfter copying the built files you can reload Obsidian to use VaultOS.\nTo distribute the plugin, package the same files in a GitHub release\nfollowing the [community plugin guidelines](https://docs.obsidian.md/Plugins/Community+plugins/Publishing+plugins).\n\n---\n\n### 🚀 Powered By\n\n- [Obsidian API](https://docs.obsidian.md/)\n- [TypeScript](https://www.typescriptlang.org/)\n- [Handlebars](https://handlebarsjs.com/) for template scaffolding\n- ❤️ Curiosity and caffeine\n\n---\n\n### 🤝 Contributing\n\nContributions welcome! Check out [`CONTRIBUTING.md`](./CONTRIBUTING.md) to learn more.\n\n---\n\n### 🧪 Status\n\nThis is an alpha kernel release of VaultOS. Expect improvements to:\n- Configuration parsing\n- UI panel features\n- Plugin lifecycle automation\n\n\u003e Built by [@PtiCalin](https://github.com/PtiCalin) · Join the [Discord](https://discord.gg/dX8ZPDrN)\n\n---\n\n\u003cp align=\"center\"\u003e\u003ci\u003e🌌 A modular engine for a modular mind.\u003c/i\u003e\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpticalin%2Fvaultos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpticalin%2Fvaultos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpticalin%2Fvaultos/lists"}