kosame

日本語版はこちら

Documentation

Features

• Class-based Models on top of Drizzle (class User extends Model {})
• DbContext-style API (context.users.find()) plus instance methods (user.save())
• Associations (hasMany/belongsTo) via batched IN (...) queries — no JOINs
• Hooks: beforeCreate / beforeUpdate / beforeDelete
• Transactions with nesting (context.transaction()), afterCommit / afterRollback
• Mixins (e.g. SoftDeletable)
• Schema validation via zod (drizzle-zod), on write and on every read
• Escape hatch to the raw Drizzle db/tx (context.raw)
• PostgreSQL, MySQL, SQLite (including Cloudflare D1)

Install

bun

bun add kosame

npm

npm install kosame

Agent skill

Kosame ships a skill that teaches coding agents (such as Claude Code) how to write Kosame code. After installing the package, copy it into your project:

npx kosame skills install --claude-md

This puts the skill in .claude/skills/kosame and adds a line to CLAUDE.md that points to it. Run the command again after upgrading kosame to update the skill.