imp-lua 0.1.1

Lua extension runtime for imp
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

# imp-lua

`imp-lua` is the Lua extension runtime for [imp](https://github.com/kfcafe/imp).

It provides the bridge between imp's Rust runtime and user/project Lua scripts that register tools, commands, and hooks.

## What this crate provides

- Lua runtime loading through `mlua`
- extension discovery and execution support
- bridge APIs for registering tools and commands
- hook integration for runtime events
- capability-aware access to shell, filesystem, HTTP, secrets, and native imp tools

## Intended use

Most users interact with this crate by writing Lua files for imp rather than depending on `imp-lua` directly.

Lua extension load paths:

- `~/.config/imp/lua/`
- `<project>/.imp/lua/`

Example:

```lua
imp.register_command("greet", {
    description = "Say hello",
    handler = function(args) return "Hello, " .. (args or "world") end
})
```

## Status

Lua is the current stable shipped extension path for imp. TypeScript compatibility exists elsewhere in imp, but it is more limited and still evolving.

## Repository

- Main README: <https://github.com/kfcafe/imp>
- Crate: <https://crates.io/crates/imp-lua>