3.7 KiB
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 commandsmake format- Format all files with biomemake check- Check syntax and linting with biomemake format-check- Format and check in sequencemake test- Run integration testsmake validate-exports- Validate import/export consistencymake verify-translations- Verify translation completenessmake validate-all- Run all validation checksmake 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 8000make clean- Clean temporary filesmake 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 tosimple_tests.jsif JSDOM unavailable) - Code formatting:
npx biome format --write . - Syntax checking:
npx biome check . - Full CI command:
make ciruns 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-sessionsto see active sessions - Use
tmux send-keys -t <session> '<command>' C-mto send commands - Use
tmux capture-pane -t <session> -pto see output - Use
tmux list-buffersto see tmux clipboard buffers - ai.foxhop.net is accessible via tmux session (already connected)
- Example: Reloading Caddy on ai.foxhop.net via tmux