# Lyt — Link Your Think

> Lyt is local-first knowledge infrastructure for Markdown-in-Git: stable identity, local indexes, and governed agent operations around files you control.

## What it is

- Markdown remains the source of truth; Lyt stores identity and derived local state alongside it.
- Vaults can be organized into meshes and a pod for scoped search, synchronization, and agent work.
- The agent interfaces are the CLI, 12 installed harness skills, and 17 typed MCP tools.
- Install the unified CLI: npm install -g @younndai/lyt

## Agent boundaries

- The MCP server runs as a local stdio child process; it does not provide an HTTP endpoint or port.
- Cross-actor sharing, unsharing, invitation acceptance, and vault abandonment are discoverable but fail closed over MCP. Use the CLI with explicit Handler confirmation.
- Capture, lexical search, and local indexing operate on local Lyt state. Sync and access operations can contact configured GitHub services when invoked.

## Toolchain

- 7 Apache-2.0 packages: @younndai/lyt, @younndai/lyt-vault, @younndai/lyt-mesh, @younndai/lyt-mcp, @younndai/lyt-skills, @younndai/lyt-runner, and @younndai/lyt-llm.
- @younndai/lyt is the unified CLI; @younndai/lyt-mcp supplies the stdio MCP server; @younndai/lyt-skills supplies the harness skills.

## Documentation

- How it works: https://linkyourthink.com/how-it-works
- Use cases: https://linkyourthink.com/use-cases
- Concepts: https://linkyourthink.com/docs/concepts
- CLI reference: https://linkyourthink.com/docs/cli
- Skills reference: https://linkyourthink.com/docs/skills
- MCP reference: https://linkyourthink.com/docs/mcp
- Packages: https://linkyourthink.com/docs/packages
- Connect an agent: https://linkyourthink.com/guides/connect-an-agent

## Machine-readable surfaces

- Human-readable map: https://linkyourthink.com/agents
- Entity manifest: https://linkyourthink.com/.well-known/egg
- JSON-LD graph: https://linkyourthink.com/graph.jsonld
- Sitemap: https://linkyourthink.com/sitemap.xml
- Crawler policy: https://linkyourthink.com/robots.txt
- This summary: https://linkyourthink.com/llms.txt

## Links

- Website: https://linkyourthink.com
- Repository: https://github.com/YounndAI/lyt
- npm: https://www.npmjs.com/package/@younndai/lyt