A way to develop from within vim

Language: Python

Vim Flow

A framework for developing from within vim. Execute your project or file from one vim command.


This plugin was built on mac and has only been tested with mac for now. However, assuming your vim was included with python 2.7, you shouldn't have any problems. No external python modules are required.

" vimrc
set rtp+=~/.vim/bundle/vundle/
call vundle#rc()

Plugin 'jonmorehouse/vim-flow'


Vim-Flow is a highly configureable framework that allows you to execute any file you happen to be editing with one command. As this project matures, more filetypes will be supported.

" execute the current file or project

" run alt command for this module

" run a command in the tmux window

" lock/unlock a file, so you can edit other files while still running flows on this file

" toggle whether or not to run flow commands in tmux or from within vim


Prefix all commands with clear

let g:flow_clean = 1

Send commands to tmux instead of executing from within vim

" you can use tmux, vim or python to run command in a new pane, within vim or silently
let g:flow_runtime = tmux 

By default, tmux commands will run in a split window in the current tmux session. You can optionally specify a different pane or session to send commands to.

let g:flow_tmux_session = "some_session_name"
let g:flow_tmux_pane = 2

Some power users may want to build their own flows to override the built in ones. By specifying a g:flow_path you can add a directory of your own flows.

let g:flow_path = $HOME."/.flows"

Flow Flags

You can add flags to any file as you are developing, or to a project as a whole by adding a .flowfile with flags.

# .flowfile

# set what command should be run
#flow-command: ls
#flow-setup: clear
#flow-teardown: echo FINISHED
#flow-runtime: tmux 


Contributions welcome. There's an endless amount of flows to be built out, from cucumber flows to docker flows. I'll be implementing them as I come across them in my own work. Open issues and fork away!

Project Statistics

Sourcerank 3
Repository Size 70.3 KB
Stars 19
Forks 2
Watchers 2
Open issues 10
Dependencies 0
Contributors 1
Tags 1
Last updated
Last pushed

Top Contributors See all

Jon Morehouse

Recent Tags See all

v0.0.1 June 02, 2014

Something wrong with this page? Make a suggestion

Last synced: 2016-05-12 22:34:31 UTC

Login to resync this repository