init-session

Initializes and validates Contextium session state, creating .contextium directory and state/task files.

1|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/shakefu/contextium --skill init-session
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init-session
Source: https://github.com/shakefu/contextium/tree/main/.claude/skills/init-session
Command: npx skills add https://github.com/shakefu/contextium --skill init-session

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill initializes and validates a Contextium session state to ensure a consistent working environment for projects.

Core Features & Use Cases

  • Creates a dedicated state directory (.contextium/) to store runtime data.
  • Verifies required tools (e.g., git, jq) and prepares session metadata (state.json, repo info, branch).
  • Initializes or resets session and task records to enable smooth onboarding and reproducible sessions.
  • Checks repository status to surface current branch and pending changes.

Quick Start

Run the initializer to establish and verify a new session:

  • ./agents/initializer.sh
  • Optional: inspect state via cat .contextium/state.json and cat .contextium/tasks.json
  • To reset and reinitialize: rm -rf .contextium/state.json; ./agents/initializer.sh

Frequently Asked Questions about init-session

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I initialize a local session state and repository metadata for development workflows?

To initialize a local session state, run the initializer script to create a dedicated state directory, verify essential tools like git and jq, and generate session metadata including state.json and tasks.json for reproducible development environments.

What does environment-check validation do for repository status and session state?

Environment-check validation verifies required tools like git and jq are present, checks repository status to surface current branch and pending changes, and ensures session state files are properly initialized before starting development workflows.

Do I need git and jq installed to initialize and validate a session state?

Yes, git and jq are required tools for session state initialization. The validation process verifies these dependencies are installed before creating the state directory and generating session metadata files for your development workflow.

How do I reset and reinitialize session state and task tracking records?

To reset and reinitialize session state, remove the state.json file from the .contextium directory using rm -rf .contextium/state.json, then run the initializer script again to regenerate session metadata and task tracking records.

What's the best way to manage local session state and task tracking across multiple projects?

Managing local session state across projects uses a dedicated .contextium directory to store runtime data, with state.json for session metadata and tasks.json for task tracking, ensuring consistent and reproducible development environments per repository.

Why does session initialization fail when repository metadata or branch information is missing?

Session initialization depends on valid repository metadata and current branch information. If git repository status cannot be determined or required tools like jq are missing, the validation step prevents creating incomplete session state files.