Skip to content

About

A VSCode extension to view and control Tilt resources

Resources

Stars

1 star

Watchers

1 watching

Forks

 
 

Latest commit

 

History

44 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tilt-view.nvim

A Neovim plugin for managing Tilt resources directly from your editor.

Note: This is a Neovim port/fork of the excellent vscode-tilt VS Code extension by JosefBud.

Important Notes

This plugin uses Tilt's internal HTTP/WebSocket API that is primarily designed for their web UI, not as a public API. As such:

  • The implementation relies on reverse-engineered endpoints and message formats
  • It may break with Tilt updates if their internal API changes
  • Some features might not work with all Tiltfile configurations
  • Some features like logs have not been implemented yet.
  • The plugin has been tested primarily with Docker Compose setups

If you encounter issues, please report them through GitHub Issues with reproducible examples. This helps improve compatibility across different Tilt configurations.

Features

  • View all Tilt resources in a floating window
  • Categorized tabs
  • Resource management: restart, enable, disable resources

Installation

Using lazy.nvim

return {
  'candtechsoftware/tilt-view.nvim',
  config = function()
    require("tilt-view").setup()
  end
}
use {
  'candtechsoftware/tilt-view.nvim',
  config = function()
    require("tilt-view").setup()
  end
}

Usage

Commands

  • :Tilt - Open the Tilt resource viewer
  • :Tilt connect - Manually connect to Tilt
  • :Tilt disconnect - Disconnect from Tilt
  • :Tilt restart <resource> - Restart a specific resource
  • :Tilt enable <resource> - Enable a specific resource
  • :Tilt disable <resource> - Disable a specific resource
  • :Tilt logs <resource> - View resource logs

Key Mappings (in Tilt window)

  • Tab / Shift-Tab - Navigate between tabs
  • j / k - Move up/down in resource list
  • Enter - View resource details
  • r - Restart resource
  • e - Enable resource
  • d - Disable resource (no confirmation)
  • l - View resource logs
  • q / Esc - Close window

Configuration

require("tilt-view").setup({
  host = "localhost",  -- Tilt server host
  port = 10350,        -- Tilt server port
})

Requirements

  • Neovim 0.7.0 or higher
  • Tilt installed and running

Resource Categorization

Resources are automatically categorized into tabs based on their type and name:

  • Services: Docker Compose services and deployments
  • Libraries: Resources with "lib" in the name
  • Tests: Resources with "test" in the name
  • Unlabeled: Resources that don't fit other categories
  • All: All resources in one view

Acknowledgments

This plugin is based on the vscode-tilt extension. Special thanks to JosefBud for the original implementation and WebSocket API research.

About

A VSCode extension to view and control Tilt resources

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages