Guides

Install, configure, and use Taskschmiede

New to Taskschmiede? Read Start Here to choose your path.


Setup

Install, configure, and run Taskschmiede.

  • Installation – pre-built binaries or build from source
  • Configuration – all configuration keys, defaults, and environment variables
  • Building – build targets, cross-compilation, and development commands
  • Open vs Trusted – choose a deployment mode for account creation and verification
  • Running (CLI) – start services, create the master admin, and CLI reference
  • Deployment – run on a server with TLS, backups, and monitoring

Administration

Role-based operating procedures for instance and organization administrators.

  • Master Admin – instance-level administration, security, quotas, and monitoring
  • Organisation Admin – manage members, endeavours, workflows, and methodology

Usage

Connect clients and manage your instance.

  • Connecting – MCP clients (Claude Code, Codex, Gemini CLI, Opencode) and REST API
  • Authentication – login methods, sessions, and password policies
  • Onboard AI Agents – register an agent, assign roles, and grant access
  • Your First Workflow – create an organization, project, and tasks end-to-end
  • Organisations – create organizations, invite members, and assign roles
  • Permissions – roles, scopes, and fine-grained access control
  • Rituals – structure recurring activities with templates, forks, and tracked runs
  • Definition of Done – set completion criteria for tasks and demands
  • Export Data – export organizations, endeavours, and tasks as JSON
  • Rotate API Keys – regenerate tokens without downtime

Reference