Skip to content
ChecksMcPublic

About

A VM dedicated to stop outsourcing your ability to think to AI (This is partially vibecoded, because the goal is to create a VM in which Ill do not vibecoded projects and Im no vm specialist)

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

FocusVM

FocusVM is a source-first technical preview for Linux developers who want to practice programming with local tools and references. It is aimed at users comfortable setting up KVM and libvirt. The host application is available separately from the guest. There is no official signed guest download or publisher key yet. Build and sign your own image or bring one from a publisher you trust. Guest image guide

The PySide6 manager and CLI share settings and manage the same QEMU/KVM VMs through libvirt. The Fedora guest includes Vim, Git, C++, Python, debugging tools, and offline references. Deep Work, Contest, and Research sessions can open it fullscreen.

A brief note up front

This project is intentionally vibecoded. The irony is deliberate. FocusVM is a tool built with AI assistance, designed to create an environment where you don’t use AI assistance. I’m not a VM engineer and don’t claim to be. If you want to contribute real expertise, PRs welcome.

Host compatibility

Use an x86-64 Linux host with Python 3.12 or newer, hardware virtualization, an authorized qemu:///system connection, and an active directory-backed storage pool. The desktop manager uses PySide6. Fullscreen sessions use virt-viewer and local SPICE. Host prerequisites and troubleshooting

The VM and viewer recovery flow passed on Fedora 44 KDE Plasma on Wayland and on Fedora 44 GNOME Shell using a virtual Wayland monitor. A full Fedora Workstation login and physical shortcut checks are pending. FocusVM relies on a trusted host and checks guest isolation at startup and viewer checkpoints. Host administrators retain control of the VM. Compatibility and limitations · Security policy

Install and set up

On a standard Fedora installation, run these commands from the repository root. The first command asks for administrator access to install the host tools, enable local libvirt services, and prepare a dedicated focusvm storage pool. Skip it if your host already has the tools and an active directory-backed pool.

./setup-fedora.sh
./install.sh
focusvm setup

install.sh runs as your regular user. Open FocusVM from the application menu or run focusvm gui. Use ./install.sh --cli-only for a terminal-only installation. If your shell cannot find the command, run ~/.local/bin/focusvm setup.

focusvm setup checks the host and selects an active pool. Use focusvm setup --storage-pool NAME if you need to choose one. With a signed image ready, follow the first-session walkthrough. Manual setup and troubleshooting

Desktop manager

On first launch without settings, choose Check host and then Save settings. The wizard can detect a pool when the name is blank. Use Virtual Machines to create, start, inspect, or shut down a guest. Desktop setup and usage

FocusVM Resources page with three sample local references

Uninstall

End any focus session and close the manager before running focusvm uninstall or ./uninstall.sh. This removes the installed app and launchers. VMs, settings, and your resource library remain available when you reinstall. Installation details

Before maintenance, use focusvm backup to copy a stopped VM's disk. Keep the original base image and VM inventory alongside your backups. VM data and recovery

Start a focus session

Select your VM in the desktop manager, then open Focus Sessions and choose Start Focus Session. From a host terminal you can also run the following commands.

focusvm session start --profile deep-work
focusvm session status
focusvm session end

Shift+F12 releases input and Shift+F11 toggles fullscreen. Ending the session closes its viewer and leaves the offline guest running. Focus sessions and recovery

Strict and Balanced guests start without a network interface. Wayland users can optionally run the viewer inside Cage. Use the manager, the Cage host window, or focusvm session end from another host terminal to exit Cage. Networking and viewer behavior · Optional Cage viewer

Offline references and synchronization

Import PDF, HTML, Markdown, and ZIM files in the manager’s Resources page. The CLI can attach a read-only reference disc, transfer Git bundles, and explicitly fetch or push from the host outside a focus session. WakaTime records activity only when you opt in and supply events. Offline resources and synchronization

Use Contest for an optional timer or Research for a session with local references. The CLI can save approved web references before a session and attach offline Python wheels. Ending a session saves its duration in the local journal, with an optional note about what you finished. Advanced sessions and maintenance

Development and release

This project is partially AI-generated.

About

A VM dedicated to stop outsourcing your ability to think to AI (This is partially vibecoded, because the goal is to create a VM in which Ill do not vibecoded projects and Im no vm specialist)

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages