{"id":33237115,"url":"https://github.com/justin2004/slimv_box","last_synced_at":"2025-12-16T02:01:54.655Z","repository":{"id":159896396,"uuid":"158961795","full_name":"justin2004/slimv_box","owner":"justin2004","description":"slimv in a container","archived":false,"fork":false,"pushed_at":"2024-03-01T21:03:13.000Z","size":57,"stargazers_count":14,"open_issues_count":0,"forks_count":1,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-03-02T21:44:11.125Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/justin2004.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-11-24T18:10:43.000Z","updated_at":"2023-10-18T14:42:28.000Z","dependencies_parsed_at":"2024-01-05T22:14:07.513Z","dependency_job_id":"cacb72d4-2894-4f95-bd16-727736325701","html_url":"https://github.com/justin2004/slimv_box","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/justin2004/slimv_box","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justin2004%2Fslimv_box","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justin2004%2Fslimv_box/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justin2004%2Fslimv_box/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justin2004%2Fslimv_box/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/justin2004","download_url":"https://codeload.github.com/justin2004/slimv_box/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justin2004%2Fslimv_box/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27758422,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-16T02:00:10.477Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-11-16T19:00:28.322Z","updated_at":"2025-12-16T02:01:54.650Z","avatar_url":"https://github.com/justin2004.png","language":"Dockerfile","readme":"### what\n\n- an IDE for Common Lisp\n- [slimv](https://github.com/kovisoft/slimv) (Superior Lisp Interaction Mode for Vim) and tmux (terminal multiplexer) in a Docker container\n- with [sbcl](http://www.sbcl.org/) and [abcl](https://common-lisp.net/project/armedbear/)\n    - you choose one at container run time with an environment variable (see below)\n- also including:\n    - [quicklisp](https://www.quicklisp.org/beta/) \n    - a copy of the common lisp hyperspec (for offline use)\n        - which opens with [w3m.vim](https://github.com/justin2004/w3m.vim) (a vim plugin for w3m)\n    - support for [CEPL](https://github.com/cbaggers/cepl) on a system without hardware acceleration\n    - [fzf](https://github.com/junegunn/fzf) (fuzzy finder)\n        - to find files in your current host directory press `:FZF` \n        - to find files in quicklisp packages press `:FZF ~` \n        - then press ctrl-x to bring that selected file into a horizontal split\n    - [vim-sexp](https://github.com/guns/vim-sexp)\n        - if you want to disable structural editing you can edit `.vimrc`, comment out `Plugin 'guns/vim-sexp'`, and rebuild the image\n\n[![asciicast](https://asciinema.org/a/314616.svg)](https://asciinema.org/a/314616)\n\n\n### why\n\n- setting up slimv the first time took me a few hours and that could be an impediment to someone attempting to use slimv so i wanted to remove the impediment for first time slimv users\n\n\n\n### how \n\n##### setup\n\n- you need to have docker installed\n\n    - [install_docker](https://docs.docker.com/install/)\n\n    - you'll probably want to follow the instructions referenced by \"Continue to Linux postinstall to allow non-privileged users to run Docker commands and for other optional configuration steps.\"\n\n\n- then you have to build this image yourself\n    - clone this repo and cd into it\n\u003e       docker build --build-arg=uid=`id -u` --build-arg=gid=`id -g` -t justin2004/slimv_box .\n\n\n- then i would create an alias in your .bashrc like this \n    - for sbcl\n\n\u003e        alias  vv='docker run --user=`id -u`:`id -u` -e CL_IMPLEMENTATION=sbcl --net=host --rm -it -v `pwd`:/mnt justin2004/slimv_box'\n\n\n- then another\n    - for abcl\n\n\u003e        alias vva='docker run --user=`id -u`:`id -u` -e CL_IMPLEMENTATION=abcl --net=host --rm -it -v `pwd`:/mnt justin2004/slimv_box'\n\n\n- then perhaps another\n    - if you want to output to X11 (for CEPL)\n\n\u003e        alias vvc='docker run -e DISPLAY=$DISPLAY -v ~/.Xauthority:/home/containeruser/.Xauthority -v /tmp/.X11-unix:/tmp/.X11-unix --user=`id -u`:`id -u` --rm -it --e CL_IMPLEMENTATION=sbcl --net=host -v `pwd`:/mnt justin2004/slimv_box'\n\n\n\n\n##### use\n\n- assuming you've built the image already \n\n- cd to the directory where you have some common lisp source files you want to edit\n\n- run \"vv\"\n\n- now you should be in the container and vim should be running inside tmux\n\n- either create a new file \":e newfile.lisp\" or open an existing one \":e oldfile.lisp\"\n\n- press ,c to start swank\n\n- you can now follow the [tutorial](https://kovisoft.github.io/slimv-tutorial/tutorial.html):\n\n- when you are done editing your .lisp files be sure to :w them, press ,Q to quit the sbcl REPL, then :q\n\n\n\n### NOTES\n\n- if you don't want to wait for the quicklisp downloads each time you start slimv_box then use a docker volume\n    - e.g.\n\u003e        alias vv='docker run --user=`id -u`:`id -u` --rm -it --net=host -v slimv_box_userhome:/home/containeruser -v `pwd`:/mnt justin2004/slimv_box'\n\n- only files in the /mnt directory (in the container) are saved when you leave vim!\n\n- don't run vv from within an existing tmux session or else you'll end up with an embedded tmux session\n\n\n- you'll need to know how to use:\n\n    - vim\n    - tmux\n    - common lisp\n    - docker (well you just need docker ce installed and your user account needs to be in the docker group)\n\n\n- TODO maybe i should add gvim and/or xterm support so that the slimv menu is visible and clickable because i bet some users would prefer the GUI-ish approach to slimv\n\n\n\n","funding_links":[],"categories":["Vim \u0026 Neovim ##"],"sub_categories":["Third-party APIs"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustin2004%2Fslimv_box","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustin2004%2Fslimv_box","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustin2004%2Fslimv_box/lists"}