Skip to content

TREF v0.1.0 MVP

Choose a tag to compare

View all tags
@lpmwfx lpmwfx released this 06 Jan 17:19
· 97 commits to main since this release
v0.1.0
fa861ca

TREF v0.1.0 - Traceable Reference Format

First release of TREF - an open, transportable, and verifiable block format for preserving, validating, and reusing knowledge with traceable source origin.

Features

  • Content-addressed blocks with SHA-256 IDs
  • Block derivation with parent lineage tracking
  • Reference types: URL, archive snippet, search prompt, hash
  • License preservation (default: CC-BY-4.0)
  • MCP server for AI integration

CLI Commands

  • tref publish - Create and publish blocks
  • tref derive - Derive from parent blocks
  • tref validate - Validate block integrity
  • tref list - List published blocks
  • tref info - Show block details
  • tref cat - Output block content

Installation

Linux/macOS

curl -sSL https://raw.githubusercontent.com/lpmwfx/tref/main/release/scripts/install.sh | bash

Windows (PowerShell)

iwr https://raw.githubusercontent.com/lpmwfx/tref/main/release/scripts/install.ps1 -UseBasicParsing | iex

Claude Code MCP Server

claude mcp add --scope user --transport stdio tref -- tref-mcp

Downloads

  • Linux: tref-linux-x64, tref-0.1.0-linux-x64.tar.gz, tref_0.1.0-1_amd64.deb
  • macOS: tref-macos-x64, tref-macos-arm64
  • Windows: tref-win-x64.exe

Build from Source

Prerequisites

  • Node.js 20+
  • npm

Build executables

git clone https://github.com/lpmwfx/tref.git
cd tref
npm install
npm run build
# Executables in dist/

Build RPM package (Fedora/RHEL)

# Install rpmbuild
sudo dnf install rpm-build

# Create RPM structure
mkdir -p ~/rpmbuild/{BUILD,RPMS,SOURCES,SPECS,SRPMS}

# Copy binary
cp dist/tref-linux-x64 ~/rpmbuild/BUILD/tref
cp dist/tref-mcp-linux-x64 ~/rpmbuild/BUILD/tref-mcp

# Create spec file
cat > ~/rpmbuild/SPECS/tref.spec << 'SPEC'
Name:           tref
Version:        0.1.0
Release:        1%{?dist}
Summary:        Traceable Reference Format CLI
License:        MIT
URL:            https://tref.lpmwfx.com

%description
Command-line tools for publishing and managing TREF blocks.

%install
mkdir -p %{buildroot}/usr/bin
cp %{_builddir}/tref %{buildroot}/usr/bin/
cp %{_builddir}/tref-mcp %{buildroot}/usr/bin/
chmod 755 %{buildroot}/usr/bin/tref %{buildroot}/usr/bin/tref-mcp

%files
/usr/bin/tref
/usr/bin/tref-mcp
SPEC

# Build RPM
rpmbuild -bb ~/rpmbuild/SPECS/tref.spec
# Output: ~/rpmbuild/RPMS/x86_64/tref-0.1.0-1.*.rpm

macOS code signing

macOS binaries must be signed before use:

# After downloading
codesign --sign - tref-macos-x64
codesign --sign - tref-mcp-macos-x64
# Or for arm64
codesign --sign - tref-macos-arm64
codesign --sign - tref-mcp-macos-arm64

Build from npm (alternative)

npm install -g aiblocks
# Provides: tref, tref-mcp

Documentation

https://tref.lpmwfx.com

Assets 16
Loading