Skip to content

Commit b810eb3

Browse files
committed
Refactor mise documentation and enhance journal entries
- Updated the May 10, 2025 journal entry to improve organization and clarity regarding MCP servers and CLI tools. - Added a new journal entry for May 11, 2025, detailing mise documentation, including tools and usage instructions. - Created new pages for mise tools, including core and overview documentation, enhancing accessibility and usability for users. - Revised existing documentation to clarify nested configurations and common commands for mise, improving overall guidance.
1 parent 3170648 commit b810eb3

8 files changed

Lines changed: 80 additions & 34 deletions

journals/2025_05_10.md

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,18 @@
22
- [[Person/Joel Hooks]]
33
- {{embed ((681f8a57-f13e-47a5-8306-2fec723a6010))}}
44
- ## Logseq
5-
- [[Logseq/npm/@logseq/nbb-logseq]]
6-
- [[Person/Gabriel Horner/GitHub/logseq-query]]
7-
- [[Logseq/MCP/Server/Survey/Report]]
8-
- [[Logseq/Proj/LsqMCP/PRD]]
9-
- #Filed
10-
- [[Logseq/MCP/Server/Py/mcp-server-logseq]]
11-
- [[Logseq/MCP/Server/JS/@joelhooks/logseq-mcp-tools]]
12-
- [[Logseq/MCP/Server/Py/ergut/mcp-logseq-server]]
13-
- [[Logseq/MCP/Server/Py/apw124/logseq-mcp]]
14-
- [[Logseq/MCP/Server/Py/ruliana/mcp-pkm-logseq]]
5+
- MCP servers
6+
- [[Logseq/Proj/LsqMCP/PRD]]
7+
- Survey of options [[Logseq/MCP/Server/Survey/Report]]
8+
- #Filed - from most to least promising
9+
- [[Logseq/MCP/Server/Py/mcp-server-logseq]]
10+
- [[Logseq/MCP/Server/JS/@joelhooks/logseq-mcp-tools]]
11+
- [[Logseq/MCP/Server/Py/apw124/logseq-mcp]]
12+
- [[Logseq/MCP/Server/Py/ergut/mcp-logseq-server]]
13+
- [[Logseq/MCP/Server/Py/ruliana/mcp-pkm-logseq]]
14+
- CLI Tools
15+
- [[Logseq/npm/@logseq/nbb-logseq]]
16+
- [[Person/Gabriel Horner/GitHub/logseq-query]]
1517
- ## Programming Languages
1618
- #Filed
1719
- [[Query Languages]]

journals/2025_05_11.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
## mise
2+
- #Filed
3+
- [[mise/Docs/Tool/Overview]]
4+
- [[mise/Docs/Tool/Core]]
5+
-

pages/Logseq___MCP___Server___Survey___Report.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ tags:: [[MCP/Server]], [[ChatGPT/Deep Research/Response]]
33
- # Survey of available Logseq [[MCP/Server]]s and their abilities
44
- ## [[My Notes]]
55
- [[2025-05-10 Sat]]
6+
id:: 681f8bab-19c2-4241-9ce4-53a5b6f7bc97
67
- Most promising
78
- [[Logseq/MCP/Server/Py/mcp-server-logseq]]
89
- {{embed ((681f9320-8043-48e5-9f1a-bf9877268de6))}}

pages/mise___Docs___Guides___Walkthrouh.md

Lines changed: 39 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,23 @@ tags:: [[Tutorial]]
44
- ## [[mise/Config/mise.toml]]
55
- commit it to the repo to share
66
- use `mise.local.toml` to `.gitignore` for personal preferences
7-
- ### nested configurations
7+
- ### cascading or nested configurations for `mise.toml`
88
- `mise` supports nested configuration files that cascade from broad to specific settings:
99
- `~/.config/mise/config.toml` - Global settings for all projects
1010
- `~/work/mise.toml` - Work-specific settings
1111
- `~/work/project/mise.toml` - Project-specific settings
1212
- `~/work/project/mise.local.toml` - Project-specific settings that should not be shared
1313
- `mise` will use all the parent directories together to determine the set of tools—overriding configuration as it goes lower in the hierarchy.
1414
- #Tip - Use [[mise/config/ls]] to see the configuration files currently used by mise.
15+
- ### [[My Notes]] on `mise.toml`
16+
- [[2025-05-11 Sun]]
17+
- #### [[CLI command]] to find the currently active mise config #card
18+
- [[mise/config/ls]] - `mise config ls` - run this to find the currently active mise config
19+
- Here's a [[mise/Task]] definition for the mise config file which will use [[mise/config/ls]] to find the currently active mise config and open it in preferred [[IDE]] - (Cursor, here)
20+
- ```toml
21+
[tasks]
22+
config = "cursor $(mise config ls | head -n1 | awk '{print $1}' | sed \"s|~|$HOME|\")"
23+
```
1524
- ## Setting [[EnvVar]]s - [[mise/EnvVar]]s
1625
- #Example - note, this can also be added to [[mise/Config/mise.toml]]
1726
- ```
@@ -83,17 +92,20 @@ tags:: [[Tutorial]]
8392
MY_PROJ_LIB = "{{config_root}}/lib"
8493
LD_LIBRARY_PATH = "/some/path:{{env.MY_PROJ_LIB}}"
8594
```
86-
- ## [[mise/Task]]
95+
- ## [[mise/Task]]s
8796
- tasks can be defined in [[mise/Config/mise.toml]]
97+
collapsed:: true
8898
- ```toml
8999
[tasks]
90100
build = "npm run build"
91101
test = "npm run test"
92102
```
93103
- or in your project dir, apparently one can put `mise-tasks/build.sh` and `mise run build` will work just as well
94-
- > [[mise/run]] sets up the "mise environment" before running task.
104+
- collapsed:: true
105+
> [[mise/run]] sets up the "mise environment" before running task.
95106
- ir you activate mise, you don't need to worry about this, but if not, `mise run X` will set up env vars first.
96107
- ### Task Usage Spec
108+
collapsed:: true
97109
- [[Observation/My]] mise has what appears to be its own language for describing a custom way to invoke a command. much as one can use a makefile, using mise, one can make `mise-tasks/gree` with a shell script like this, and it will set up tab complete and make it so certain CLI arguments are actually created as [[EnvVar]]s.
98110
- ```sh
99111
#!/usr/bin/env bash
@@ -132,6 +144,7 @@ tags:: [[Tutorial]]
132144
The directory to greet from
133145
```
134146
- example run
147+
collapsed:: true
135148
- ```
136149
mise run greet --user me -g "hey" "how are you"
137150
[greet] $ ~/Documents/GitHub/logseq-encode-garden/mise-tasks/greet --user me -g hey how are you
@@ -143,24 +156,27 @@ tags:: [[Tutorial]]
143156
hey, me! Your message is: how are you
144157
```
145158
- In my testing, the tab completion did not play well with [[Zsh/OhMyZsh]] autocompletions
146-
- ## [Common Commands](https://mise.jdx.dev/walkthrough.html#common-commands) [[mise/Commands]]
147-
- [[mise/completion]] - Set up completions for your shell
148-
- [[mise/config]] aka [[mise/cfg]] - A bunch of commands for working with `mise.toml` files via the CLI
149-
- [[mise/exec]] aka [[mise/x]] - Execute a command in the mise environment without activating mise
150-
- [[mise/generate]] aka [[mise/g]] - Generates things like git hooks, task documentation, GitHub actions, and more for your project
151-
- [[mise/install]] aka [[mise/i]] - Install tools
152-
- [[mise/link]] - Symlink a tool installed by some other means into mise
153-
- [[mise/ls-remote]] - List all available versions of a tool
154-
- [[mise/ls]] - Lists information about installed/active tools
155-
- [[mise/outdated]] - Informs you of any tools with newer versions available
156-
- [[mise/plugin]] - Plugins can extend mise with new functionality like extra tools or environment variable management
157-
- Commonly, these are simply asdf/vfox plugins
158-
- [[mise/run]] aka [[mise/r]] - Run a task defined in `mise.toml` or `mise-tasks`
159-
- [[mise/self-update]] - Update mise to the latest version
160-
- Don't use this if you installed mise via a package manager
161-
- [[mise/settings]] - CLI access to get/set configuration settings
162-
- [[mise/uninstall]] aka [[mise/rm]] - Uninstall a tool
163-
- [[mise/upgrade]] aka [[mise/up]] - Upgrade tool versions
164-
- [[mise/use]] aka [[mise/u]] - Install and activate tools
165-
- [[mise/watch]] aka [[mise/w]] - Watch for changes in a project and run tasks when they occur
159+
- ## [Common Commands](https://mise.jdx.dev/walkthrough.html#common-commands) [[mise/Commands]]
160+
collapsed:: true
161+
- [[mise/completion]] - Set up completions for your shell
162+
- [[mise/config]] aka [[mise/cfg]] - A bunch of commands for working with `mise.toml` files via the CLI
163+
- [[mise/exec]] aka [[mise/x]] - Execute a command in the mise environment without activating mise
164+
- [[mise/generate]] aka [[mise/g]] - Generates things like git hooks, task documentation, GitHub actions, and more for your project
165+
- [[mise/install]] aka [[mise/i]] - Install tools
166+
- [[mise/link]] - Symlink a tool installed by some other means into mise
167+
- [[mise/ls-remote]] - List all available versions of a tool
168+
- [[mise/ls]] - Lists information about installed/active tools
169+
- [[mise/outdated]] - Informs you of any tools with newer versions available
170+
- [[mise/plugin]] - Plugins can extend mise with new functionality like extra tools or environment variable management
171+
collapsed:: true
172+
- Commonly, these are simply asdf/vfox plugins
173+
- [[mise/run]] aka [[mise/r]] - Run a task defined in `mise.toml` or `mise-tasks`
174+
- [[mise/self-update]] - Update mise to the latest version
175+
collapsed:: true
176+
- Don't use this if you installed mise via a package manager
177+
- [[mise/settings]] - CLI access to get/set configuration settings
178+
- [[mise/uninstall]] aka [[mise/rm]] - Uninstall a tool
179+
- [[mise/upgrade]] aka [[mise/up]] - Upgrade tool versions
180+
- [[mise/use]] aka [[mise/u]] - Install and activate tools
181+
- [[mise/watch]] aka [[mise/w]] - Watch for changes in a project and run tasks when they occur
166182
-

pages/mise___Docs___Tool___Core.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
alias:: [[mise/Docs/Core Tools]]
2+
3+
- # [Core Tools | mise-en-place](https://mise.jdx.dev/core-tools.html)
4+
- [[mise/Docs/Tool/Core/NodeJS]]
5+
- [[mise/Docs/Tool/Core/Python]]
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# [Python | mise-en-place](https://mise.jdx.dev/lang/python.html)
2+
- ## [[My Notes]]
3+
- [[2025-05-11 Sun]]
4+
- [[mise/use/-g]]
5+
- `mise use -g python@3.13` to set the default version of python in [[mise/Config/mise.toml]]. An advantage of this over [[mise/install]] is that it installs it and updates it in the config at the same time.
6+
- `mise use -g uv@latest` - this will install [[uv]] as well and mise will utilize it going forwards for python.
7+
- [[see-also]]
8+
- [[mise/Docs/Cookbook/Python]]
9+
- ## [Usage](https://mise.jdx.dev/lang/python.html#usage)
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
alias:: [[mise/Docs/Dev Tools Overview]]
2+
3+
- # [Dev Tools | mise-en-place](https://mise.jdx.dev/dev-tools/)
4+
- ## [How it works](https://mise.jdx.dev/dev-tools/#how-it-works)
5+
id:: 682090e2-b6c2-47ae-a404-d806aab03b3d
6+
- mise hooks into your shell (with `mise activate zsh`) and sets the `PATH` environment variable to point your shell to the correct runtime binaries. When you `cd` into a directory containing a `mise.toml`/`.tool-versions` file, mise will automatically set the appropriate tool versions in `PATH`.

pages/mise___cookbook___python.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,4 @@
1-
# [Mise + Python Cookbook | mise-en-place](https://mise.jdx.dev/mise-cookbook/python.html)
1+
alias:: [[mise/Docs/Cookbook/Python]]
2+
3+
- # [Mise + Python Cookbook | mise-en-place](https://mise.jdx.dev/mise-cookbook/python.html)
24
-

0 commit comments

Comments
 (0)