time-awareness

Claude Code Toolkit

A collection of powerful plugins and tools to supercharge your Claude Code experience.

🚀 What's Included

🔌 Plugins

1. Time Awareness Plugin - Automatic temporal context

   • 20+ environment variables with date/time info
   • Business hours, market hours, weekend detection
   • Runs automatically on every session start
   • No wrapper scripts needed!

2. Discord-Postgres Dev - Expert agents for Discord bot development

   • Discord.py 2.4+ expert agent
   • PostgreSQL expert agent (asyncpg, SQLAlchemy 2.0+)
   • Complete bot builder coordinator
   • 2025 modern libraries and patterns

🛠️ Tools

• Time Awareness Installer - Shell installer for time-awareness wrapper script
  • Bash/Zsh version for Linux/macOS/WSL
  • PowerShell version for Windows
  • Exports temporal variables before launching Claude Code

📚 Documentation

Complete guides and examples in the docs/ folder.

---

📦 Quick Start

Installing Plugins

Method 1: From GitHub (Recommended)

# Add this repository as a marketplace
claude plugin marketplace add Sycochucky/claude-code-toolkit

# Install individual plugins
claude plugin install time-awareness@Sycochucky-claude-code-toolkit
claude plugin install discord-postgres-dev@Sycochucky-claude-code-toolkit

Method 2: Local Installation

# Clone the repository
git clone https://github.com/Sycochucky/claude-code-toolkit.git
cd claude-code-toolkit

# Add as local marketplace
claude plugin marketplace add ./plugins/time-awareness
claude plugin marketplace add ./plugins/discord-postgres-dev

# Install plugins
claude plugin install time-awareness@local-time-awareness
claude plugin install discord-postgres-dev@local-discord-postgres

---

🔌 Plugins

Time Awareness Plugin

Automatic temporal context for Claude Code

Exports 20+ environment variables on every session start:

• Timestamps (UTC, local, Unix)
• Calendar context (day of week, week number, quarter)
• Smart flags (business hours, market hours, weekend)
• Timezone information

Features:

• ✅ No wrapper scripts needed
• ✅ Automatic on every session
• ✅ SessionStart hook
• ✅ Comprehensive time data

Installation:

claude plugin install time-awareness@Sycochucky-claude-code-toolkit

Usage: Just restart Claude Code! The hook runs automatically and you'll see:

🕐 Temporal Context Loaded: Thursday, November 20, 2025 at 04:15:30 AEDT
📅 2025-11-20 | ⏰ Week 47, Q4 | 🌍 AEDT
💼 Business Hours: false | 📈 Market Hours: false | 🎉 Weekend: false

Full Documentation →

---

Discord-Postgres Dev Plugin

Expert agents for modern Discord bot development

Three specialized agents using 2025 best practices:

• discordpy-expert - Discord.py 2.4+ (commands, events, UI)
• postgres-expert - PostgreSQL (schema, queries, optimization)
• bot-builder - Complete feature coordinator

Features:

• ✅ discord.py 2.4+ with slash commands
• ✅ asyncpg + SQLAlchemy 2.0 async ORM
• ✅ Pydantic v2 validation
• ✅ Production-ready patterns

Installation:

claude plugin install discord-postgres-dev@Sycochucky-claude-code-toolkit

Usage:

# Use via Task tool
Task(
    subagent_type="discord-postgres-dev:bot-builder",
    prompt="Create a leveling system with /rank and /leaderboard",
    description="Build leveling system"
)

Full Documentation →

---

🛠️ Tools

Time Awareness Installer (Legacy)

Shell installer for time-awareness wrapper script

Before the plugin existed, this was the way to add time awareness via a wrapper script.

Note: The plugin is now recommended over the wrapper script!

Files:

• install-claude-time-awareness.sh - Bash/Zsh installer
• Install-ClaudeTimeAwareness.ps1 - PowerShell installer

Installation:

bash tools/install-claude-time-awareness.sh

Then use:

claude-time --show-context

Full Documentation →

---

🏗️ Repository Structure