Archived

forked from Rockachopa/Timmy-time-dashboard

This repository has been archived on 2026-03-24. You can view files and clone it. You cannot open issues or pull requests or push a commit.

Files

Hermes Agent 6233a8ccd6 feat: Add Kimi agent workspace with development scaffolding

Create the Kimi (Moonshot AI) agent workspace per AGENTS.md conventions:

Workspace Structure:
- .kimi/AGENTS.md - Workspace guide and conventions
- .kimi/README.md - Quick reference documentation
- .kimi/CHECKPOINT.md - Session state tracking
- .kimi/TODO.md - Task list for upcoming work
- .kimi/notes/ - Working notes directory
- .kimi/plans/ - Plan documents
- .kimi/worktrees/ - Git worktrees (reserved)

Development Scripts:
- scripts/bootstrap.sh - One-time workspace setup (venv, deps, .env)
- scripts/resume.sh - Quick status check + resume prompt
- scripts/dev.sh - Development helpers (status, test, lint, format, clean, nuke)

Features:
- Validates Python 3.11+, venv, deps, .env, git config
- Provides quick status on git, tests, Ollama, dashboard
- Commands for testing, linting, formatting, cleaning

Per AGENTS.md:
- Kimi is Build Tier for large-context feature drops
- Follows existing project patterns
- No changes to source code - workspace only

2026-03-14 14:30:38 -04:00

2.2 KiB

Raw Blame History

Kimi Agent Workspace

Agent: Kimi (Moonshot AI)
Role: Build Tier - Large-context feature drops, new subsystems, persona agents
Branch: kimi/agent-workspace-init
Created: 2026-03-14

Quick Start

# Bootstrap Kimi workspace
bash .kimi/scripts/bootstrap.sh

# Resume work
bash .kimi/scripts/resume.sh

Kimi Capabilities

Per AGENTS.md roster:

Best for: Large-context feature drops, new subsystems, persona agents
Avoid: Touching CI/pyproject.toml, adding cloud calls, removing tests
Constraint: All AI computation runs on localhost (Ollama)

Workspace Structure

.kimi/
├── AGENTS.md           # This file - workspace guide
├── README.md           # Workspace documentation
├── CHECKPOINT.md       # Current session state
├── TODO.md             # Task list for Kimi
├── scripts/
│   ├── bootstrap.sh    # One-time setup
│   ├── resume.sh       # Quick status + resume
│   └── dev.sh          # Development helpers
├── notes/              # Working notes
└── worktrees/          # Git worktrees (if needed)

Development Workflow

Before changes:
- Read CLAUDE.md and AGENTS.md
- Check CHECKPOINT.md for current state
- Run make test to verify green tests
During development:
- Follow existing patterns (singletons, graceful degradation)
- Use tox -e unit for fast feedback
- Update CHECKPOINT.md with progress
Before commit:
- Run tox -e pre-push (lint + full CI suite)
- Ensure tests stay green
- Update TODO.md

Useful Commands

# Testing
tox -e unit              # Fast unit tests
tox -e integration       # Integration tests
tox -e pre-push          # Full CI suite (local)
make test                # All tests

# Development
make dev                 # Start dashboard with hot-reload
make lint                # Check code quality
make format              # Auto-format code

# Git
bash .kimi/scripts/resume.sh     # Show status + resume prompt

Contact

Gitea: http://localhost:3000/rockachopa/Timmy-time-dashboard
PR: Submit PRs to main branch

2.2 KiB Raw Blame History