TackOS
TackOSGitHub

Open source

Repository guide

TackOS is MIT licensed and open for contributions. This page covers installation, project structure, architecture, and how to contribute.

github.com/tackos/tackos

Install

$git clone https://github.com/tackos/tackos
$cd tackos
$pnpm install
$pnpm dev

Also available via npx create-tackos-company

Project structure

/appNext.js App Router pages
/app/launch-soonInteractive company runtime
/app/docsDocumentation pages
/app/securityTrust model documentation
/components/landingLanding page sections
/components/dashboardRuntime dashboard panels
/components/sharedNavbar, Footer, Logo, SectionHeader
/components/uiDesign system primitives (badge, button, dialog…)
/dataFixture data: agents, tasks, approvals, logs, proof packets
/lib/types.tsTypeScript type definitions
/lib/utils.tsFormatting, classname helpers
/lib/storage.tslocalStorage state hook
/styles/globals.cssOKLCH design tokens, panel classes, animations

Architecture overview

TackOS uses a control-plane architecture. The UI and runtime are cleanly separated from the data layer. All state in the local prototype is kept in localStorage — no API calls, no external services.

The production architecture will route all agent actions through a Policy Gateway that enforces budget limits, role checks, and approval gates before any real tool is called.

TackOS UI

→ Mission Engine

→ Department Runtime

→ Policy Gateway

→ Agent Adapters

→ External Tools

→ Proof Ledger

Contributing

TackOS welcomes contributions. See CONTRIBUTING.md in the root of the repository for the full guide.

Quick steps:

# Fork and clone

$git clone https://github.com/<your-username>/tackos

$cd tackos && pnpm install

# Create a feature branch

$git checkout -b feat/your-feature

# Run dev

$pnpm dev

# Open a pull request against main

License

TackOS is licensed under the MIT License. You are free to use, modify, distribute, and build commercial products with this codebase. See the LICENSE file in the repository root.

Roadmap

V0

  • ·Local runtime with mock data
  • ·Full dashboard surfaces
  • ·localStorage persistence
  • ·Complete documentation

V1

  • ·Real agent adapter SDK
  • ·Policy gateway enforcement
  • ·Docker deployment
  • ·GitHub adapter
  • ·MCP support

V2

  • ·Department marketplace
  • ·Multi-company workspace
  • ·Enterprise audit controls
  • ·Cost optimization engine

About the local runtime

The current repository is a local prototype. All data is mocked. No agents are executing in real time. No real tools are called. The runtime illustrates the product mechanics — departments, missions, approvals, proof packets, cost intelligence — using local fixtures and localStorage.

Open Company Runtime