imps

Intelligence MetaProgramming System — scriptable AI agents defined in Markdown. The document is the program.

# Workflow: prose becomes prompt, components become actions
imps workflow run examples/workflows/blog-post.mdx --input topic="distributed systems"

# Agent: markdown defines identity, inline tools define capabilities
imps agent examples/agents/WeatherAssistant

From Idyllic Labs, where we research composable primitives for programmable intelligence.

Install

Bun-only. Runs TypeScript source directly via Bun APIs. Node.js is not supported.

bun install -g @idyllic-labs/imps

Packages

Package	Description
agent	Persistent tool-calling agents — identity and inline tools in a single .mdx file
workflow	Deterministic document execution — prose accumulates context, components control flow
cli	Unified CLI dispatcher

Examples

• examples/agents/ — WeatherAssistant, DevAssistant, ToolsDemo
• examples/workflows/ — blog-post, interview-prep, product-naming, lesson-plan, code-review

Development

bun install              # install deps
bun run typecheck        # typecheck all packages
bun run test             # run tests
bun run lint && bun run format   # lint + format

License

MIT

---

Idyllic Labs · San Francisco