Getting Started

Temper gives your work a throughline — the connective thread across sessions, decisions, and evolving understanding. Everything resolves to markdown.

Install

cargo install temper-cli

Or build from source:

git clone https://github.com/tasker-systems/temper.git
cd temper
cargo install --path crates/temper-cli

CLI Commands

Core

`temper init`	Initialize a new vault
`temper check`	Verify vault integrity and tool health
`temper status`	Vault overview
`temper warmup --context <ctx>`	Context primer for new sessions
`temper doctor`	Validate frontmatter and repair drift
`temper events`	Show recent vault events

Resources

All document types (task, goal, session, research, concept, decision) are managed through the unified resource command with --type.

`temper resource create --type task --title <t>`	Create a task
`temper resource create --type goal --title <t>`	Create a goal
`temper resource create --type session --title <t>`	Create a session note
`temper resource create --type research --title <t>`	Create a research note
`temper resource create --type concept --title <t>`	Create a concept note
`temper resource create --type decision --title <t>`	Record a decision
`temper resource list`	List all resources across types
`temper resource list --type task`	List resources of a specific type
`temper resource list --type goal`	List goals with task stage counts
`temper resource show <slug>`	Show a resource (accepts slug, suffix, or seq number)
`temper resource update <slug> --title <t>`	Update a resource's title or metadata
`temper resource update <slug> --context-to <ctx>`	Move a resource to a different context
`temper resource update <slug> --type-to <type>`	Change a resource's type

Search

temper search <query> Full-text and semantic search across the knowledge base

Contexts and Skills

`temper context add <name>`	Add a context
`temper context list`	List contexts
`temper skill generate`	Generate CLI reference from current commands
`temper skill install`	Install skill files and command wrapper
`temper skill check`	Check skill installation status

Cloud

`temper auth login`	Authenticate with temper cloud
`temper sync run`	Sync local vault with temper cloud
`temper sync status`	Show sync status without changes
`temper pull <resource>`	Pull a resource from the cloud
`temper remove <resource>`	Remove a resource from the cloud

MCP Server

The remote MCP server exposes vault operations as structured tools over Streamable HTTP. Agents authenticate via Auth0 using the standard OAuth 2.1 + PKCE flow.

Available Tools

`list_resources`	List resources, filtered by context name and/or doc type name. Most recent first.
`get_resource`	Get a resource by ID or slug, optionally with full markdown content
`create_resource`	Create a resource with optional markdown content. Name-based context and doc type.
`update_resource`	Update a resource's title, slug, or content. New content triggers re-indexing.
`delete_resource`	Soft-delete a resource by ID
`search`	Full-text and semantic search across the knowledge base
`list_contexts`	List available contexts (workspaces)
`get_context`	Get details of a specific context
`create_context`	Create a new context (workspace)
`list_doc_types`	List available document types
`list_events`	List events, optionally filtered by resource or type
`get_profile`	Get the authenticated user's profile

Connect

Add to your Claude Desktop or Claude Code MCP configuration:

{
  "mcpServers": {
    "temper": {
      "url": "https://temperkb.io/mcp"
    }
  }
}

The client handles OAuth automatically — you'll be prompted to log in on first connection.

Claude Code Integration

Generate a Claude Code skill file tailored to your vault:

temper skill install

To automatically prime new sessions with recent context, add a SessionStart hook:

{
  "hooks": {
    "SessionStart": [{
      "hooks": [{
        "type": "command",
        "command": "temper warmup --context myapp"
      }]
    }]
  }
}

← Back to home