@idyllic-labs/imps
v0.1.0-alpha.5
Published
Scriptable AI agents defined in Markdown. Write an .mdx file, get a tool-calling agent with a TUI.
Downloads
51
Maintainers
Readme
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/WeatherAssistantFrom 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/impsPackages
| 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, ToolsDemoexamples/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 + formatLicense
MIT
Idyllic Labs · San Francisco
