| ▲ | LNAI – Define AI coding tool configs once, sync to Claude, Cursor, Codex, etc.(github.com) |
| 54 points by iamkrystian17 7 hours ago | 22 comments |
| |
|
| ▲ | juunge 19 minutes ago | parent | next [-] |
| I really like the idea of an agent package manager! I built something similar aiming to be like uv but for AI agents https://github.com/kasperjunge/agent-resources |
| |
| ▲ | iamkrystian17 12 minutes ago | parent [-] | | It is not really an agent package manager. It is a tool to sync agents configs.
I checked out agent-resources, cool idea, maybe if lnai gains some traction I could contribut to your tool so it supports importing skills to .ai/ :) |
|
|
| ▲ | embedding-shape 5 hours ago | parent | prev | next [-] |
| Hmm, maybe it's just me, but it's a good thing the different agents use different files, different models needs different prompts. Using the same system/user prompts across all three will just give you slightly worse results in one of them, instead of getting the best results you can from each one of them. At least for the general steering system prompts. Then for the application specific documentation, I'd understand you'd want to share it, as it stays the same for all agents touching the same codebase. But easily solved by putting it in DESIGN.md or whatever and appending "Remember to check against DESIGN.md before changing the architecture" or similar. |
| |
| ▲ | scosman an hour ago | parent | next [-] | | It's great to have the option to optimize for different models, but I'm not going to on 99% of projects. And a good chunk of the agent docs are model agnostic (how to run linter, test libraries/practices). It's cool to have a way to reuse easily, even if that's copying AGENTS.md into the right places. | | |
| ▲ | embedding-shape an hour ago | parent [-] | | > And a good chunk of the agent docs are model agnostic (how to run linter, test libraries/practices). Personally I put stuff like that in the readme, since it's useful stuff for humans too, not directions just for machines, and I'm mostly building for other humans. The lighter and smaller the AGENTS.md end up, the better the models are at following it too, from what I can tell. |
| |
| ▲ | iamkrystian17 5 hours ago | parent | prev [-] | | Totally valid take. Models might have different prompting guidelines for best results. If a developer uses one tool and wants to optimize their config as much as possible for that specific tool, LNAI is probably not for them. However given how many tools there are and how fast each tool moves, I find myself jumping between them quite often, just to see which ones I like most or if some tool have improved since I lasted checked it. In this case LNAI is very helpful. | | |
| ▲ | embedding-shape 5 hours ago | parent [-] | | > I find myself jumping between them quite often, just to see which ones I like most or if some tool have improved since I lasted checked it. In this case LNAI is very helpful. Most prompts I do I execute in all four at the same time, and literally compare the git diff from their work, so I understand totally :) But even for comparison, I think using the same identical config for all, you're not actually seeing and understanding the difference because again, they need different system prompts. By using the same when you compare, you're not accurately seeing the best of each model. | | |
| ▲ | iamkrystian17 5 hours ago | parent [-] | | Fair point. LNAI does support per-tool config overrides in .ai/.{codex/claude/cursor/etc.} directories, so you kind of get the best of both worlds :) You can sync identical configs, while having the flexibility to define per-tool configs where needed, while keeping a single source of truth in the .ai/ directory. |
|
|
|
|
| ▲ | shj2105 an hour ago | parent | prev | next [-] |
| How is this different than Agents.md? Isn’t it just easier just to have one agents.md file? |
| |
| ▲ | iamkrystian17 an hour ago | parent [-] | | Agents.md is usually only a part of ai coding tool config. LNAI handles syncing additional configs like skills, sub-dir rules, mcps, permissions to every tool.
Additionally, even thought AGENTS.md is popular, not every tool supports that standard. |
|
|
| ▲ | optikalfire 4 hours ago | parent | prev | next [-] |
| Is this substantially different than https://github.com/intellectronica/ruler? Or how would you differentiate? |
| |
| ▲ | intellectronica 4 hours ago | parent | next [-] | | Looks very similar. That's good - diversity and more options are good. But ... as the author and maintainer of Ruler I can tell you that I don't use it and I don't recommend using it (or this new tool). In almost all cases it isn't necessary anymore - most agents support AGENTS.md (or at least a hack like `@AGENTS.md` in CLAUDE.md), and Agent Skills are the best way to customise agents and are available everywhere now. There are some corner cases where using a tool like Ruler may still make sense, but if in doubt, you probably don't need it. | | |
| ▲ | iamkrystian17 4 hours ago | parent | next [-] | | Yup with simple AGENTS file and skills, tools like ruler/lnai might be an overkill. However I still think that they are needed for MCPs/Permissions/sub-dir rules/different skills formats. I would really like all AI agents coding tools to have the same config formats, but I feel like we are not there yet :/ | |
| ▲ | hboon 4 hours ago | parent | prev [-] | | Yes, just softlink (or @-mention). I'm more concerned about incompatible file formats (eg. with skills). |
| |
| ▲ | iamkrystian17 4 hours ago | parent | prev [-] | | At a glance there are a few differences:
- LNAI additionally supports permissions
- The way rules for sub-directories are defined is different. Ruler defines rules for sub-directories in the sub-directories themselves under ‘.ruler/‘. LNAI defines rules for sub-directories by using front matter ‘paths’ property and storing all rules under ‘.ai/rules’
- ruler supports more tools (I will continue maintaining and improving lnai to also support more tools / configs)
- lnai supports per tool overrides in ‘.ai/.{codex/claude/etc.}’ for more granular control while keeping a single source of truth
- ruler is a more mature package |
|
|
| ▲ | anupamchugh 5 hours ago | parent | prev | next [-] |
| This solves distribution well. Curious about the change propagation story though - what happens when you update your .ai/ source and tools have cached/transformed versions? I ran into this building a spec/skill sync system [1] - the "sync once" model breaks down when you need to track whether downstream consumers are aware of upstream changes. [1] https://github.com/anupamchugh/shadowbook
|
| |
| ▲ | iamkrystian17 5 hours ago | parent [-] | | For files that don't need transformation (AGENTS.md, skills, most rules), LNAI creates symlinks. .claude/CLAUDE.md → ../.ai/AGENTS.md. Edit the source, all tools see it immediately. For transformed files (Cursor's .mdc frontmatter, GEMINI.md sub-directory rules), you re-run lnai sync. LNAI maintains a manifest tracking of every generated file with content hashes, so it knows what changed and cleans up orphans automatically. So it's not really "sync once", it's "symlink for instant propagation, regenerate-on-demand for transforms." The manifest ensures LNAI always knows its downstream state. This system can also break down if you create new skills/rules in the specific tool directories (.claude, .codex, etc.) but that is against LNAI's philosophy. If you need per-tool overrides you put them in `.ai/.{claude/codex/etc.}` sub-directories and LNAI manages them for you. |
|
|
| ▲ | OsamaJaber 6 hours ago | parent | prev | next [-] |
| Nice. The config fragmentation across tools is a real annoyance
Does it handle conflicts if tools expect different formats for the same setting? |
| |
| ▲ | iamkrystian17 5 hours ago | parent [-] | | Yes, the tool takes that into account and transforms mcps/permissions/rules to different tool formats.
Sadly some tools might not support fine-grained permissions (e.g. Codex) in which case a warning will be displayed but everything else will get transformed/symlinked.
Additionally you can put per-tool overrides in ‘.ai/{codex/claude/cursor/etc.}/‘ if needed and lnai will automatically symlink those overrides to respective tools. |
|
|
| ▲ | iamkrystian17 7 hours ago | parent | prev | next [-] |
| I've been using Claude Code, Cursor, and Codex on the same projects. Each tool has its own config format: Claude wants `.claude/`, Cursor wants `.cursor/`, Codex wants `.codex/`. Every time I updated a skill/rule, I had to update it in 3+ places. Usually I'd forget one, and my tools would give inconsistent suggestions.
LNAI is a CLI that lets you define your AI configs once in a `.ai/` directory: .ai/
├── AGENTS.md
├── rules/
├── skills/
└── settings.json # MCP servers, permissions Run `lnai sync` and it exports to native formats for 7 tools: Claude Code, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf, and Codex.
The interesting part is it's not just copying files. Each tool has quirks: - Cursor wants `.mdc` files with `globs` arrays in frontmatter
- Gemini reads rules at the directory level, so rules get grouped
- Permissions like `Bash(git:*)` become `Shell(git)` for Cursor
- Some tools don't support certain features (e.g., Cursor has no "ask" permission level). LNAI warns but doesn't fail Where possible, it uses symlinks. So `.claude/CLAUDE.md` → `../.ai/AGENTS.md`. Edit the source, all tools see the change immediately without re-syncing. Usage: npm install -g lnai
lnai init # Creates .ai/ directory
lnai validate # Checks for config errors
lnai sync # Exports to all enabled tools It's MIT licensed. The code is TypeScript with a plugin architecture, each tool is a plugin that implements import/export/validate.
GitHub: https://github.com/KrystianJonca/lnai
Docs: https://lnai.sh Would appreciate feedback, especially from anyone else dealing with this config hell problem. |
|
| ▲ | zaptheimpaler 5 hours ago | parent | prev [-] |
| I’ve been using chezmoi to manage dot files, that should be enough to handle AI config too. It’s easier to just have one tool do all of that. |
| |
| ▲ | iamkrystian17 5 hours ago | parent [-] | | For simple config files like AGENTS.md/skills that is true.
But some configs like MCPs/Permissions/Rules require transformations per tool. On lnai's per-tool docs pages (e.g. https://lnai.sh/tools/codex/) I have documented what transforms are needed per-tool. There are quite a few of them. |
|