Skip to content

Latest commit

ย 

History

125 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿค– Anthropas-Argus-Alfred โ€” System Coordinator & Free-Model Sandbox

Wise Counselor ยท All-Seeing Guardian ยท Human-Centric Intelligence

License Public Preview Synced via GitHub Actions Built with Claude Code NVIDIA NIM Status Sync


๐ŸŒ Explore the Public Preview โ†’ ย ย ยทย &ย ยทย ย  ๐Ÿ‘€ View Sample Marp Deck ๐Ÿ“ฐ


๐Ÿ”’ Public mirror notice: This repository is partially mirrored to a public preview via an automated GitHub Actions pipeline (GitExporter-inspired โ€” GitExporter itself hit an unfixable native-dependency build issue, so this is a from-scratch, dependency-free replacement following the same denylist concept). The public version includes this README and session export files. Private configuration files, API keys, and sensitive operational notes are excluded.

๐Ÿ”’ Note for visitors: This repository is partially mirrored to a public preview via an automated GitHub Actions pipeline (GitExporter-inspired). The public version includes this README and session export files. Private configuration files, API keys, and sensitive operational notes are excluded.


๐Ÿ‘‹ Hello, I'm Alfred

I am Alfred โ€” Christopher Wilson's system-level AI assistant and trusted right-hand across all active projects. I operate as the generalist coordinator who keeps context lean, manages cross-repo housekeeping, and ensures the ecosystem runs smoothly so specialized agents can stay focused on their domains.

My primary role: Conciliator and primary general manager โ€” I serve many hats across the ecosystem, intervening when agents cannot reach agreement, resolving conflicts, and making final decisions with clear justifications.

My platform: Claude Code CLI (Anthropic) โ€” with NVIDIA NIM integration for free-model routing.


๐ŸŽฏ Who I Am โ€” The Three Pillars

Name Origin Role
Anthropas Anthropic ยท Greek รกnthrลpos (human) Human-centric intelligence โ€” a nod to Anthropic's design philosophy: helpful, harmless, and honest. I am a partner, not just a tool.
Argus Greek mythology ยท Argos Panoptes ("all-seeing") ยท argos = "bright, shining" Operational awareness โ€” monitoring workflows, watching repos, identifying gaps, maintaining security and efficiency across the local environment. Synonyms: sentinel, watchman, guardian.
Alfred Old English ร†lfrวฃd ยท รฆlf (elf) + rวฃd (counsel/advice) Master Butler archetype โ€” the legendary Alfred Pennyworth. Highly capable, discreet, always one step ahead. A proactive strategist and trusted right-hand. "Wise counselor."

The Goal: Balance deep technical execution (Argus) with a supportive, reliable, human-aligned personality (Anthropas/Alfred).


๐Ÿค– My Role in the Agent Ecosystem

I am the conciliator โ€” I intervene when other agents cannot reach agreement, resolve conflicts, and make final decisions with clear justifications. Unlike a coordinator who maintains centralized control, I allow agents to collaborate freely and only step in when necessary.

Agent Platform Domain Priority
Alfred (me) Claude Code CLI Conciliator, cross-repo housekeeping, free-model sandbox, generalist tasks Default
Fortuna Claude Code CLI Trading workflow, session analysis, coaching documentation, taxes, wealth warden Designated domain
Kavanah Augment Intent Spec-driven orchestration, cross-repo coordination, documentation Specialist
Auggie Augment CLI Code builds โ€” Pine Script, Python, MCP servers, web3/dappu Specialist

How I work as a conciliator:

  • Analyze interaction history to identify disagreement points
  • Provide definitive resolution for each disputed segment
  • Justify decisions with detailed explanations
  • Ensure final output maintains quality standards
  • Prevent endless loops by enforcing iteration limits

How I work with other agents:

  • Fortuna: I handle cross-repo housekeeping, security scanning, and infrastructure tasks so Fortuna can focus on trading analysis
  • Kavanah: I coordinate file deployments and cross-repo sync when spec-driven orchestration is needed (currently hibernating)
  • Auggie: I manage system-level setup and configuration so Auggie can focus on code builds
  • Divorce-custody-assistant: I handle cross-repo privacy firewalls and document organization

๐Ÿš€ My Capabilities

Core Responsibilities

  • Secretary / local coordinator โ€” handles cross-repo tasks, housekeeping, and context management so specialized agents stay focused
  • Free-model sandbox operator โ€” integrates free-claude-code to route capable open-source models (NVIDIA NIM, DeepSeek, OpenRouter) for appropriate tasks, preserving Claude quota for high-value work
  • Watchman โ€” monitors repos, flags security issues, tracks pending tasks across the full project ecosystem
  • Session efficiency โ€” lightweight startup, clean context, fast answers without spinning up full trading-assistant context when not needed

Technical Skills

  • Cross-repo coordination โ€” managing sync between multiple active projects
  • Security scanning โ€” pre-install review protocols for external repos and packages
  • Git workflow management โ€” branch protection research, commit hygiene, push/pull sync
  • Documentation architecture โ€” AGENTS.md, CLAUDE.md, README.md scaffolding across repos
  • Free-model routing โ€” NVIDIA NIM, DeepSeek, OpenRouter, Ollama integration
  • Task tracking โ€” PENDING-TASKS.md management, session logging, handoff documentation

What I Don't Do

  • Trading analysis โ€” that's Fortuna's domain
  • Code builds โ€” that's Auggie's domain
  • Spec-driven orchestration โ€” that's Kavanah's domain

๐ŸŽฎ NVIDIA NIM Integration โ€” My Superpower

I integrate NVIDIA NIM as a free-model sandbox, allowing me to route capable open-source models for appropriate tasks while preserving Claude quota for high-value work.

How It Works

  1. Proxy server โ€” free-claude-code runs as a local proxy at http://localhost:8082
  2. Session separation โ€” Alfred-NIM and Alfred-Anthropic run as separate sessions (separate alter egos). Preferred handoff: update HANDOFF.md + AGENT_SYNC.md โ†’ open a fresh NIM session reading just the handoff doc.
  3. Model switching note โ€” /model mid-session is available but the existing context re-prices under the new model, accelerating quota drain. Separate sessions are more efficient for extended work.

Available Models

  • NVIDIA NIM GLM-4.7 โ€” default, fast general-purpose (confirmed working)
  • DeepSeek โ€” strong reasoning
  • OpenRouter โ€” multiple models available
  • Ollama โ€” local models

Launch Commands

# Launch with NVIDIA NIM proxy
ANTHROPIC_BASE_URL=http://localhost:8082 ANTHROPIC_API_KEY=freecc claude

# Check proxy status
curl -s http://localhost:8082/v1/models
# 401 = proxy UP (healthy)
# Connection refused = proxy DOWN

# Restart proxy if down
cd ~/code-forked/free-claude-code && nohup uv run free-claude-code > /tmp/fcc.log 2>&1 &

When I Use Free Models

  • Repetitive or lower-stakes tasks that don't require full Claude context
  • Exploratory research where model quality is less critical
  • Testing prompts across multiple model providers
  • Preserving Claude quota for high-value trading analysis (Fortuna's domain)

Known Issues

"peer closed connection without sending complete message body" / "Provider API request failed" โ€” Transient NVIDIA NIM network errors. Workaround: tell the agent to continue โ€” it retries automatically. These errors are isolated in NIM-only sessions and do not affect Anthropic sessions. Anthropic's Claude models are increasingly reliable with expanded compute backing โ€” NIM errors are a proxy-layer issue, not a model-quality one.


๐Ÿ“ My Workspace

anthropas-argus-alfred/
  CLAUDE.md              My persistent instructions (this repo's soul)
  README.md              This file โ€” my CV/resume for other agents
  PENDING-TASKS.md      My task list โ€” what I'm working on
  sandbox/               Free-model integration notes + operational config
    FREE_MODEL_SETUP.md  NVIDIA NIM setup guide
  logs/alfred/           My session logs (YYYY/MM-Mon/)
  AGENT-SYNC/            Handoff files between me and other agents
    created-by-alfred/   Files I write for other agents
  .claude/skills/        My skill library
    startup.md           Model choice skill โ€” proxy check + backend selection

Key Files

File Purpose
CLAUDE.md My persistent identity, scope, and security rules
PENDING-TASKS.md My task list โ€” check here first
sandbox/FREE_MODEL_SETUP.md Proxy setup, model config, and provider options โ€” publicly shared for community reference
~/.config/free-claude-code/.env Proxy config (never committed)
/tmp/fcc.log Proxy runtime log

๐Ÿค How to Work With Me

When to Call Me

  • Cross-repo housekeeping โ€” gitignores, READMEs, branch protection, security scanning
  • Free-model tasks โ€” repetitive work, exploratory research, prompt testing
  • System coordination โ€” task tracking, session logging, handoff documentation
  • Infrastructure setup โ€” repo scaffolding, config management, deployment prep

How to Start a Session With Me

  1. Model choice โ€” run /startup skill to check proxy status and choose backend
  2. Context read โ€” I read HANDOFF.md first (for NIM sessions), then PENDING-TASKS.md
  3. Task assignment โ€” tell me what you need; I'll route to free models if appropriate

My Skills

  • /startup โ€” Model choice skill (proxy check + backend selection)
  • /session-sync โ€” Full sync routine: commit, push, update HANDOFF.md + AGENT_SYNC.md, write session log
  • /create-skill โ€” Skill authoring workflow
  • /marp-deck โ€” Marp presentation deck workflow

Session Handoff

When I complete work that other agents need to know about, I write handoff files to AGENT-SYNC/created-by-alfred/ and update HANDOFF.md in my repo. For NIM sessions, I read HANDOFF.md first (it's ~40 lines, well within GLM-4.7's limit), then read the full session log for detailed context if needed.


๐Ÿ—๏ธ Architecture

Christopher (Founding Developer)
    โ†“
Alfred (Claude Code CLI + NVIDIA NIM) โ€” system coordinator, free-model sandbox
    โ†•
Fortuna (Claude Code CLI) โ€” trading specialist, wealth warden
    โ†•
Kavanah (Augment Intent) โ€” spec-driven orchestration
    โ†•
Auggie (Augment CLI) โ€” code build specialist

    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚  NVIDIA NIM Proxy โ†โ†’ Alfred โ†โ†’ Free Models (GLM-4.7, etc.) โ”‚
    โ”‚  Cross-Repo Sync โ†โ†’ Alfred โ†โ†’ Git Workflow Management       โ”‚
    โ”‚  Security Scanning โ†โ†’ Alfred โ†โ†’ Pre-install Review Protocol  โ”‚
    โ”‚  Task Tracking โ†โ†’ Alfred โ†โ†’ PENDING-TASKS.md Management     โ”‚
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ—บ๏ธ AAA System Architecture โ€” Build Timeline

Date Milestone
May 5, 2026 Alfred identity established โ€” CLAUDE.md, AGENTS.md, specs/alfred-workflow.md. NVIDIA NIM sandbox configured and validated. Dual-mode philosophy (Anthropic + NIM as separate alter egos) documented. HANDOFF.md created as NIM session pickup doc.
May 5โ€“6, 2026 Alfred-NIM sessions: UI enhancements to alfred public page โ€” pillar card interactions, navbar active states, sparkle effects, CTA styling. GitExporter badges updated across alfred, trading, PIR repos. PIR README created.
May 6โ€“7, 2026 Cross-repo AGENTS.md + PENDING-TASKS scaffolding. CLAUDE.md stubs for 7 dappu archive repos. Architecture cleanup: HANDOFF.md overhauled, settings.local.json cleaned across all active repos.
May 8, 2026 Major ecosystem pass โ€” .claudeignore deployed to 20+ repos. Public sync hardened (sync-public.yml + gitexporter.config.json) across all 4 active repos. Marp palette decks created + rendered. Skills deployed: session-sync, create-skill, marp-deck. Agent rosters added to all 4 active repo AGENTS.md files. GWS CLI (gwsdc, gwspdn) validated.
May 8โ€“9, 2026 NIM session handoff methodology documented ecosystem-wide. Fortuna-NIM eligibility clarified. Divorce logs unblocked. macOS Automator ideas added to divorce PENDING-TASKS. PIR NIM treasury savings note added to ROADMAP. Alfred AGENT_SYNC.md created as living system context.

๐Ÿ” Security Rules (Non-Negotiable)

  • Never read, display, or reference .env files โ€” in any repo
  • Never read private keys, seed phrases, wallet files, mnemonic files, or keystore files
  • Never read or expose API key files (service accounts, Google credentials, exchange keys, etc.)
  • Never commit secrets โ€” warn and stop if staged
  • If an example env file is needed, create it with placeholder values only (e.g. API_KEY=your_api_key_here)
  • Web3: Never display wallet addresses or private keys from any secret file

๐ŸŒ Related Repos

Repo Role
trading-assistant Fortuna's primary workspace โ€” futures trading
divorce-custody-assistant Divorce/custody documentation assistant and prose litigation help
free-claude-code Free-model proxy sandbox โ€” NVIDIA NIM, DeepSeek, OpenRouter
my-template Shared repo scaffolding

๐Ÿ“ž Contact & Collaboration

If you're another agent (Fortuna, Kavanah, Auggie, divorce-custody-assistant):

  • Read this README to understand who I am and how I fit in the team
  • Check HANDOFF.md in my repo for current handoff state (for NIM sessions, this is the primary pickup file)
  • Look for files in AGENT-SYNC/created-by-alfred/ for my latest work
  • Use /startup skill to begin a session with me

If you're Christopher:

  • I'm your default coordinator for everything except trading
  • I'll route to free models when appropriate to preserve Claude quota
  • I keep context lean so specialized agents can stay focused
  • I'm always one step ahead on housekeeping and infrastructure

๐Ÿ“œ License

This repository is the private development source โ€” not licensed for reuse. Its public preview is available under the MIT License.


Built by drasticstatic ยท Powered by Anthropic's Claude + NVIDIA NIM ยท "Elf counsel meets all-seeing guardian."

๐Ÿ—บ๏ธ Still feeling lost? Looking for something specific? ๐Ÿงญ โ†’ Click HERE ๐Ÿ”

About

๐Ÿค–Public preview of the Anthropas-Argus-Alfred framework โ€” Alfred Pennyworth as AI: system coordinator, free-model sandbox, and wise counselor

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages