安装

curl https://raw.githubusercontent.com/inhere/kite/master/deploy/install.sh| bash

cd~git clone https://github.com/inhere/kite .kitecd .kitecomposer installchmod a+x bin/kitecp .kite.example.php .kite.phpsudo ln -s$PWD/bin/kite /usr/local/bin/kite# 检查安装是否成功kite --version

wget -c https://github.com/inhere/kite/releases/latest/download/kite.phar

wget -c https://github.com/inhere/kite/releases/download/v2.0.0/kite.phar

mv kite.phar /usr/local/bin/kitechmod a+x /usr/local/bin/kite

配置工具

生成自动补齐脚本

kite --auto-completion \  --shell-env zsh \  --gen-file~/.oh-my-zsh/completions/_kite \  --tpl-file resource/templates/completion/zsh.tpl

kite --auto-completion \  --shell-env zsh \  --gen-file~/.oh-my-zsh/custom/plugins/kite/kite.plugin.zsh \  --tpl-file resource/templates/completion/zsh.plugin.tpl

kite --auto-completion \  --shell-env bash \  --gen-file \  --tpl-file resource/templates/completion/bash.tpl

常用命令组别名

## aliases for kite# NOTICE: zsh plugin support add aliasesalias kj="kite jump"alias kg="kite git"alias kgit="kite git"alias kgl="kite gitlab"alias kgh="kite github"alias kjson="kite json"

使用说明

查看命令帮助

kitekite list

kite -hkite --helpkitehelp

Git 使用

命令格式

kite git {COMMAND} [arguments ...] [--options ...]# 配置了shell aliaskg {COMMAND} [arguments ...] [--options ...]

Git常用命令

kite git ac -m"commit message"

kite git acp -m"commit message"# 可以使用别名快速操作kite acp -m"commit message"

kite git branch# 别名kite git br

# 列出所有，包含remotes的分支列表kite git br -a# 查看本地分支列表并根据关键字 'fix' 搜索kite git br -s fix# 查看指定remote的分支列表kite git br -r originkite git br -r mainkite git br -r main -s fix# 仅简单的打印分支名称kite git br --only-name# 仅打印分支名称并且以逗号分割显示在一行kite git br --only-name

kite git tag-push -v v1.0.2 -m"release new version"# 简写别名kite git tn -v v1.0.2 -m"release new version"# 自动计算和创建下一个版本分支kite git tn --next

kite git log# 别名kite git lg

kite git cl v1.1.2 v1.1.3# 可以使用关键字kite git cl last headkite git cl prev last

kite git changelog last head --style gh-release --no-mergeskite git changelog v2.0.9 v2.0.10 --no-merges --style gh-release --exclude"cs-fixer,format codes"

Gitlab 使用

命令格式

kite gitlab {command} [arguments ...] [--options ...]

相关配置

'gitlab' => [// remote'mainRemote' =>'main','forkRemote' =>'origin',// 分支别名'branchAliases'    => ['h' =>'head',    ]],

命令使用

kite gl nbr fix_210423# 配置了shell aliaskgl nbr fix_210423

kite gl update# 简写别名kite gl up

kite gl updatePush# 简写别名kite gl upp

# @ 默认会从当前分支 发起到主仓库 对应的当前分支的PRkite gl pr -o @# -o 跟分支，则会从当前分支 发起到主仓库 里给定分支的PRkite gl pr -o qakite gl pr -o prekite gl pr -o master

# 打开Fork仓库地址(即origin对应的)kite gl open# 打开主仓库地址kite gl open --main

kite gl db'fix_210423,fix_210321'# 强制执行，忽略执行中的错误kite gl db'fix_210423,fix_210321' -f

Github 使用

命令格式

kite github {command} [arguments ...] [--options ...]

'github' => [// remote'mainRemote' =>'main',// 'source''forkRemote' =>'origin','redirectGit'   => ['acp','log','info','push','fetch','update','tagNew','changelog',    ],],

# -o 不跟分支，默认会从当前分支 发起到主仓库 对应的当前分支的PRkite gl pr -o# -o 跟分支，则会从当前分支 发起到主仓库 里给定分支的PRkite gl pr -o mainkite gl pr -o master

kite gh open

快速跳转目录

配置命令脚本

# default shell func is: jumpeval"$(kite jump shell bash)"# set the bind func name is: jeval"$(kite jump shell bash --bind j)"

# default shell func is: jumpeval"$(kite jump shell zsh)"# set the bind func name is: jeval"$(kite jump shell zsh --bind j)"

开始使用

# TIP: 内部会自动转换 ~ 为绝对路径$ kite jumpset home~$ kite jumpset wp~/Workspace

$ j /Users/inhere/Workspace/javaINTO: /Users/inhere/Workspace/java$ j /Users/inhere/Workspace/godevINTO: /Users/inhere/Workspace/godev

其他常用命令

expr 简易表达式

kite expr -i

json5 内容读取

kite json5 FILE

markdown 渲染

kite markdown FILE

php开发服务器

'php:serve'     => ['hce-file' =>'test/httptest/http-client.env.json','hce-env'  =>getenv('APP_ENV') ?:'dev',// document root'root'     =>'public','entry'    =>'public/index.php','php-bin'  =>'php7'// 'addr' => '127.0.0.1:8552',    ],

{"dev": {"host":"127.0.0.1:10106"  },"test": {"host":"127.0.0.1:10106"  }}

kite php serve

ENV环境信息

kite env

$ kite env pathPath Value  /usr/local/sbin  /usr/local/bin  /usr/bin  /bin  /usr/sbin

$ kite env terMatched Results(Kw:ter)  TERMINAL_EMULATOR JetBrains-JediTerm  TERM              xterm-256color  ZSH_TMUX_TERM     screen-256color

扩展使用

使用脚本

脚本文件

['scriptRunner' => ['enable'  =>true,// 'scriptExts' => []// 'scriptExt2bin' => []    ],'scriptDirs' => [$basePath .'/script',$basePath .'/custom/script',    ],]

kite SCRIPT-FILENAMEkite run SCRIPT-FILENAME

脚本命令

<?php// custom scripts for quick run an commandreturn ['echo' =>'echo hi','test' => ['echo $SHELL','echo hello'    ],// git quick use'gst'  =>'git status','st'   =>'git status','co'   =>'git checkout $@','br'   =>'git branch $?','pul'  =>'git pul $?','pull' =>'git pull $?',];

kite run gst

命令别名

// command aliases. element is: alias command => real command'aliases' => ['ac'     =>'git:ac','acp'    =>'git:acp','glpr'   =>'gitlab:pr','config' =>'self config',    ],

命令插件

'pluginDirs' => ['~/.kite/plugin/'    ],

<?phpuseInhere\Console\IO\Output;useInhere\Kite\Console\CliApplication;useInhere\Kite\Console\Plugin\AbstractPlugin;/** * Class DemoPlugin */class DemoPluginextends AbstractPlugin{publicfunctionmetadata():array    {return ['desc' =>'this is am demo plugin',        ];    }publicfunctionexec(CliApplication$app,Output$output):void    {vdump(__METHOD__);    }}

kite plugin run PLUGIN_NAME

kite plugin run demo-plugin

# 后缀 .php 可以忽略kite demo-pluginkite demo-plugin.php# 直接写完整路径也是可以的kite plugin/demo-pluginkite plugin/demo-plugin.php

更新kite

kite selfupdate

cd~/.kitegit pullchmod a+x bin/kite

构建Phar包

php -d phar.readonly=0 bin/kite phar pack

删除工具

rm -f /usr/local/bin/kiterm -rf~/.kite

Dep Packages

Refer