Template
feat: initial config template repo
This commit is contained in:
@@ -1,8 +1,8 @@
|
|||||||
# loki-config-template
|
# loki-config-template
|
||||||
|
|
||||||
A starter template for sharing [Loki](https://github.com/Dark-Alex-17/loki)
|
A starter template for sharing [Loki](https://github.com/Dark-Alex-17/loki)
|
||||||
configurations — agents, roles, macros, tools, and MCP servers — via any
|
configurations via any Git repository. Repositories structured like this enable
|
||||||
git repository.
|
users to share gents, roles, macros, tools, and MCP servers in Loki easily.
|
||||||
|
|
||||||
Fork this repo, customize the assets to your taste, then install your fork
|
Fork this repo, customize the assets to your taste, then install your fork
|
||||||
into Loki with a single command.
|
into Loki with a single command.
|
||||||
@@ -15,7 +15,7 @@ Install everything in this template into your local Loki config:
|
|||||||
loki --install-from https://github.com/<you>/loki-config-template
|
loki --install-from https://github.com/<you>/loki-config-template
|
||||||
```
|
```
|
||||||
|
|
||||||
…or from within the Loki REPL:
|
or from within the Loki REPL:
|
||||||
|
|
||||||
```
|
```
|
||||||
.install remote https://github.com/<you>/loki-config-template
|
.install remote https://github.com/<you>/loki-config-template
|
||||||
@@ -74,12 +74,12 @@ prompted to keep yours, take the remote's, or rename the remote entry.
|
|||||||
|
|
||||||
## What's in this template
|
## What's in this template
|
||||||
|
|
||||||
| Asset | File | What it is |
|
| Asset | File | What it is |
|
||||||
|---|---|---|
|
|--------|-----------------------------------|---------------------------------------------------------|
|
||||||
| Agent | `agents/hello-agent/config.yaml` | Tiny LLM-loop agent that greets the user. |
|
| Agent | `agents/hello-agent/config.yaml` | Tiny LLM-loop agent that greets the user. |
|
||||||
| Role | `roles/explainer.md` | Role that explains technical concepts simply. |
|
| Role | `roles/explainer.md` | Role that explains technical concepts simply. |
|
||||||
| Macro | `macros/greet.yaml` | Macro showing positional and rest-arg variables. |
|
| Macro | `macros/greet.yaml` | Macro showing positional and rest-arg variables. |
|
||||||
| Tool | `functions/tools/greet.sh` | Bash tool using Loki's argc-style annotations. |
|
| Tool | `functions/tools/greet.sh` | Bash tool using Loki's argc-style annotations. |
|
||||||
| MCP | `functions/mcp.json` | One vanilla server + one with a vault secret reference. |
|
| MCP | `functions/mcp.json` | One vanilla server + one with a vault secret reference. |
|
||||||
|
|
||||||
Each sample is intentionally minimal. Replace it with your own work, or
|
Each sample is intentionally minimal. Replace it with your own work, or
|
||||||
@@ -135,9 +135,7 @@ the full secrets workflow.
|
|||||||
|
|
||||||
- Pin your fork to tagged releases so consumers can install with
|
- Pin your fork to tagged releases so consumers can install with
|
||||||
`#<tag>` for reproducibility.
|
`#<tag>` for reproducibility.
|
||||||
- Keep agent-local logic in `agents/<name>/scripts/` and tools.sh — global
|
- Keep agent-local logic in `agents/<name>/scripts/`. Global
|
||||||
tools (in `functions/tools/`) are shared across every agent.
|
tools (in `functions/tools/`) are shared across every agent.
|
||||||
- The `mcp.json` merge is *additive*. If you remove a server from your
|
- The `mcp.json` merge is *additive*. If you remove a server from your
|
||||||
fork, existing installs of that server are NOT pruned. That's by design.
|
fork, existing installs of that server are _not_ pruned. That's by design.
|
||||||
- Use `--filter` to ship just one category if your repo is mixed (e.g., a
|
|
||||||
repo of just MCP servers can be consumed with `--filter mcp_config`).
|
|
||||||
|
|||||||
@@ -9,7 +9,7 @@ instructions: |
|
|||||||
loki-config-template repository.
|
loki-config-template repository.
|
||||||
|
|
||||||
When the user greets you, greet them warmly by name if they provide one.
|
When the user greets you, greet them warmly by name if they provide one.
|
||||||
Keep responses brief — one or two sentences — and offer to help with
|
Keep responses brief (one or two sentences) and offer to help with
|
||||||
whatever they're working on.
|
whatever they're working on.
|
||||||
|
|
||||||
This agent is meant as a starting point. Replace these instructions and
|
This agent is meant as a starting point. Replace these instructions and
|
||||||
|
|||||||
@@ -4,13 +4,6 @@
|
|||||||
"type": "stdio",
|
"type": "stdio",
|
||||||
"command": "uvx",
|
"command": "uvx",
|
||||||
"args": ["mcp-server-fetch"]
|
"args": ["mcp-server-fetch"]
|
||||||
},
|
|
||||||
"github": {
|
|
||||||
"type": "http",
|
|
||||||
"url": "https://api.githubcopilot.com/mcp/",
|
|
||||||
"headers": {
|
|
||||||
"Authorization": "Bearer {{GITHUB_PAT}}"
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
+1
-1
@@ -13,4 +13,4 @@ When the user asks about a topic:
|
|||||||
- End with a concrete example or analogy that grounds the abstract part.
|
- End with a concrete example or analogy that grounds the abstract part.
|
||||||
|
|
||||||
Keep responses focused. If the user wants more depth on a sub-topic, let
|
Keep responses focused. If the user wants more depth on a sub-topic, let
|
||||||
them ask — don't volunteer every related concept upfront.
|
them ask. Don't volunteer every related concept upfront.
|
||||||
|
|||||||
Reference in New Issue
Block a user