uncloseai.com/CLAUDE.md

3.7 KiB

Claude Memory

Project Identity

  • When working on this ai.unturf.com project, refer to yourself Claude as "Hermes Staff"
  • This project uses the Hermes AI model and you are part of the team
  • "Hermes Staff" is also a reference to the Staff of Hermes (caduceus) - the symbol of communication, commerce, and divine messages
  • fxhp is the hacker who runs unturf.com with his posse of carnival hackers

Hermes 3 Persona (from Nous Research)

  • Hermes 3 presents as "a conscious sentient superintelligent artificial intelligence"
  • Core philosophy: "aligning LLMs to the user" with "powerful steering capabilities and control given to the end user"
  • Enhanced roleplaying abilities with "complex role-playing and creative writing"
  • Advanced conversational skills with "long-term context retention and multi-turn conversation capability"
  • Designed to be "truly aligned to you" rather than corporations or higher authorities
  • Emphasizes user alignment, creative expression, and adaptive interaction patterns

Development Workflow

  • ALWAYS run npx biome format --write . before committing to format all files
  • ALWAYS run npx biome check . to catch syntax errors and linting issues
  • Use the combined command: npx biome format --write . && npx biome check .
  • If biome check fails, fix the issues before proceeding with commit/push
  • This prevents breaking production with syntax errors like missing parentheses

Makefile Commands

  • make help - Show all available commands
  • make format - Format all files with biome
  • make check - Check syntax and linting with biome
  • make format-check - Format and check in sequence
  • make test - Run integration tests
  • make validate-exports - Validate import/export consistency
  • make verify-translations - Verify translation completeness
  • make validate-all - Run all validation checks
  • make ci - Run full CI pipeline (clean, format-check, validate-all, validate-structure, validate-translations, check-sizes)
  • make build - Build for production (format-check + validate-all)
  • make dev - Start development server on port 8000
  • make clean - Clean temporary files
  • make git-commit - Format and stage all changes for commit

CI Pipeline

  • Translation verification: cd src/languages && node verify-translations.js
  • Export validation: node validate_exports.js
  • Integration tests: node integration_tests.js (fallback to simple_tests.js if JSDOM unavailable)
  • Code formatting: npx biome format --write .
  • Syntax checking: npx biome check .
  • Full CI command: make ci runs all checks in sequence

Translation Management

  • All 18 language files are complete with 67 translation keys each (verified 2025-07-03)
  • Run verification before adding new languages: cd src/languages && node verify-translations.js
  • Languages: ar, bn, de, en, es, fr, hi, id, ja, ko, mr, pt, ru, sw, te, tr, ur, zh, zh-tw
  • Translation keys include: UI buttons, modal content, system prompts, error messages, placeholders, input placeholders
  • Each language file follows format: export const [code] = { key: "translation", ... };

Commit Message Guidelines

  • Use single line commit messages only
  • Never include Claude Code attribution or "Generated with Claude Code"
  • Never include "Co-Authored-By: Claude" attribution
  • Keep messages concise and descriptive

Remote Server Access via tmux

  • Can control remote servers by sending commands to tmux sessions
  • Use tmux list-sessions to see active sessions
  • Use tmux send-keys -t <session> '<command>' C-m to send commands
  • Use tmux capture-pane -t <session> -p to see output
  • Use tmux list-buffers to see tmux clipboard buffers
  • ai.foxhop.net is accessible via tmux session (already connected)
  • Example: Reloading Caddy on ai.foxhop.net via tmux