HoxCore

Universal, Declarative, Version-Controlled Project Registry

Git-inspired project management for any kind of human endeavor. A single, authoritative source of truth for projects, missions, and actions.

pip install hoxcore

Why HoxCore?

🎯

Universal Registry

Manage programs, projects, missions, and actions in a single, unified system. Not just for softwareβ€”for any human endeavor.

πŸ“

Declarative & Safe

Pure YAML definitions with no executable scripts. Templates are interpreted by HoxCore itself, ensuring security and predictability.

πŸ”„

Git-Inspired

Immutable UIDs, version history, and branching semantics. Your project registry is a Git repository with full auditability.

πŸ€–

LLM-Native

Built for AI integration. Reference LLM models, knowledge bases, and let AI assistants reason over your entire project ecosystem.

πŸ”Œ

Integration-First

Connect with GitHub, Azure DevOps, Overleaf, Notion, Trello, and more. HoxCore integratesβ€”it doesn't replace.

⚑

CLI-First

Powerful command-line interface with intuitive commands. Fast queries, scalable to thousands of entities.

Quick Start

1

Install HoxCore

pip install hxc
2

Initialize a Registry

hxc init my-registry
3

Create Your First Project

hxc create project --title "My First Project" --category software.dev/cli-tool
4

List Your Entities

hxc list projects

Core Concepts

πŸ“¦ Program

An abstract container grouping related initiatives. Think of it as a portfolio or strategic theme.

🎯 Project

An object-like effort with concrete outputs. Has a defined scope, deliverables, and completion criteria.

πŸš€ Mission

An event-like or execution-oriented effort with a clear culmination. Time-bound and goal-focused.

πŸ”„ Action

An ongoing or recurring activity without a defined end. Continuous processes and operations.

All entities share a single unified YAML definition, differing only by metadata fields such as type, category, and relationships.

Learn More About Core Concepts β†’

Example Entity Definition

# Basic Metadata
type: project
id: P-001
title: "AI-Powered CLI Tool"
description: >
  Building an intelligent command-line interface
  with LLM integration and declarative templates.

# Status & Lifecycle
status: active
start_date: 2024-01-01
due_date: 2024-04-01

# Classification
category: software.dev/cli-tool.default
tags: [cli, ai, registry, tools]

# Git Integration
repositories:
  - name: github
    url: https://github.com/user/repo

# LLM Integration
models:
  - id: assistant
    provider: openwebui
    url: http://openwebui.local/?models=assistant

knowledge_bases:
  - id: kb-registry-specs
    url: http://openwebui.local/workspace/knowledge/5f0f9cc7...

# Project Management
tools:
  - name: github-projects
    provider: github
    url: https://github.com/user/repo/projects/1

Use Cases

πŸ’» Software Development

Manage multiple repositories, track features, coordinate releases, and integrate with GitHub, Azure DevOps, or GitLab.

πŸ“š Academic Research

Organize research projects, papers, experiments, and collaborate with Overleaf, Notion, and reference managers.

🏒 Business Operations

Track initiatives, programs, and strategic goals. Integrate with project management tools and databases.

🎨 Creative Projects

Manage creative endeavors, portfolios, and collaborative works with flexible categorization and tagging.

πŸ”¬ Scientific Missions

Plan and execute scientific missions, experiments, and field work with detailed metadata and tracking.

🀝 Personal Projects

Organize personal goals, hobbies, and learning projects with a structured, version-controlled approach.

Design Principles

πŸ”’

Git-like

Immutable IDs, version history, and minimal magic. Everything is traceable and auditable.

πŸ“‹

Declarative

No scripts, no hidden behavior. What you see is what you get.

🌍

Universal

Applicable beyond software development. Manage any kind of human endeavor.

🧩

Composable

Integrates instead of duplicating tools. Works with your existing ecosystem.

πŸ“ˆ

Scalable

Designed to handle thousands of entities with fast queries and efficient indexing.

πŸ€–

LLM-native

Built for both human and machine understanding. AI-ready from the ground up.

Ready to Get Started?

Install HoxCore and start managing your projects with a universal, declarative registry.