Alpha —

Universal Project Registry

Git-inspired project management for any kind of human endeavor.

A single, authoritative source of truth for programs, projects, missions, and actions— expressed as version-controlled YAML, ready for humans and LLMs alike.

Get Started Read the Docs

$ pip install hoxcore

Why HoxCore?

🎯

Universal

Manage software, research, business initiatives, creative work, and more—with one unified system.

📝

Declarative & Safe

Pure YAML definitions. No executable scripts. Templates are interpreted, never executed.

🔄

Git-Native

Immutable UIDs, full version history, branching semantics. Your registry is a Git repo.

🤖

LLM-Ready

Built for AI from day one. Reference models and knowledge bases directly in entity definitions.

🔌

Integration-First

GitHub, Azure DevOps, Notion, Overleaf, Trello—HoxCore references your tools, not replaces them.

⚡

CLI-First

Intuitive hxc commands. Fast indexed queries. Scales to thousands of entities.

Quick Start

Install

pip install hoxcore

Initialize a registry

hxc init my-registry

Create your first project

hxc create project "My First Project" \
  --category software.dev/cli-tool \
  --tags python,cli

List and query

hxc list projects
hxc list --query "My First" --status active

Full Getting Started Guide →

Four Entity Types

📦 Program

Abstract container grouping related initiatives. Portfolios, strategic themes.

🎯 Project

Concrete effort with defined scope, deliverables, and completion criteria.

🚀 Mission

Event-driven execution with a clear culmination—launches, campaigns, expeditions.

🔄 Action

Ongoing or recurring activity without a defined end—meetings, maintenance.

Explore Core Concepts →

One File. Full Context.

A single YAML definition carries everything—status, integrations, AI models, relationships. Readable by humans, parseable by LLMs.

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

status: active
start_date: 2024-01-01
due_date: 2024-12-31

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

parent: prog_digital_transformation

repositories:
  - name: github
    url: https://github.com/sdescobedo/hoxcore

models:
  - id: assistant
    provider: ollama
    model: llama3

knowledge_bases:
  - id: kb-project-docs
    path: ./docs/

tools:
  - name: github-projects
    provider: github
    url: https://github.com/sdescobedo/hoxcore/projects/1

Use Cases

💻 Software Development

Track repositories, features, releases. Integrate with GitHub, Azure DevOps, or GitLab.

📚 Academic Research

Organize papers, experiments, datasets. Connect to Overleaf, Notion, reference managers.

🏢 Business Operations

Strategic initiatives, programs, goals. Link project management tools and databases.

🎨 Creative Projects

Portfolios, collaborations, long-form works—with flexible categorization and tagging.

🔬 Scientific Missions

Plan field work, experiments, and expeditions with rich metadata and tracking.

🤝 Personal Goals

Organize personal learning, hobbies, and side projects with a structured approach.