CLI Reference

The KoLmafia Graphical CLI is one of the most helpful features it has. This page is intended to provide information on the commands available.

Inventory Management

Command	Arguments	Description
acquire	item	Ensures you have argument item, making or buying when necessary.

Other

Command Name	Arguments	Description
!		list the Dungeons of Doom potions you've identified.
*.php*		visit URL without showing results.
*brewery*[?]	[ daily special | item ]	show daily special [or consume it or other restaurant item].
*kitchen*[?]	item	consumes item at Hell's Kitchen, if available.
*mirror*	[filename]	stop [or start] logging to an additional file.
<inline-ash-script>		embed an ASH script in a CLI script.
aa	skill	set default attack method.
abort	[message]	stop current script or automated task.
acquire	item	ensure that you have item, creating or buying it if needed.
adv*[?]	last | [count] location	spend your turns.
alias	[ word => expansion ]	list or create CLI abbreviations.
ash	statement	test a line of ASH code without having to edit a script.
ashref	[filter]	summarize ASH built-in functions [matching filter].
attack	[ target [, target]... ]	PvP for dignity or flowers
autoattack	skill	set default attack method.
automall		dump all profitable, non-memento items into the Mall.
autosell	item [, item]...	autosell items.
backtrace	text | off	dump stack when a gCLI message or page URL matches text (case-sensitive).
bake	[ item... ]	list creatables, or create specified items.
bang		list the Dungeons of Doom potions you've identified.
basement		check Fernswarthy's Basement status.
breakfast		perform start-of-day activities.
budget	[number]	show [or set] the number of budgeted Hagnk's pulls.
buffbot	number	run buffbot for number iterations.
-num		use excess/all/specified/all but specified MP for buff extension and summons.
buy	item [@ limit] [, another]...	buy from NPC store or the Mall.
call	[numberx] filename | function [parameters]	check/run script.
camp*	rest | etc. [numTimes]	perform campground actions.
cast[?]	[ [count] skill [on player] ]	list spells, or use one.
ccs	[script]	show [or select] Custom Combat Script in use.
cecho	color text	show text using color (specified by name or #RRGGBB).
chamber		automatically complete quest.
chat		switch to tab or open window
[,[-]item]...	[; cmds]	compare prices, do cmds with "it" replaced with best.
check	mp | mana | both	attempt to regain some HP or MP.
checkpoint		remembers current equipment, use "outfit checkpoint" to restore.
chew[?]	[either] item [, item]...	use/consume items
clan	[ snapshot | stashlog ]	clan management.
cleanup		use, pulverize, or autosell your junk items.
clear		clear CLI window.
closet	take item...	list or manipulate your closet.
cls		clear CLI window.
colorecho	color text	show text using color (specified by name or #RRGGBB).
condition*	add condition | set condition	modify your adventuring goals.
condref		list conditions usable with if/while commands.
council		visit the Council to advance quest progress.
counters	[ clear | add number [title img] ]	show, clear, or add to current turn counters.
create	[ item... ]	list creatables, or create specified items.
csend	message ]	send kmail
debug	[on] | off	start or stop logging of debugging data.
demons		list the demon names you know.
disable	all | command [, command]...	allow/deny CLI commands.
display	take item...	list or manipulate your display case.
donate	jarl | mys | pete | mox amount	donate in Hall of Legends.
drink[?]	[either] item [, item]...	use/consume items
dusty		list the dusty bottles of wine you've identified.
eat[?]	[either] item [, item]...	use/consume items
echo	timestamp | text	include timestamp or text in the session log.
effects	[param]	list indicated type of data, possibly filtered by param.
else	; commands	do commands if preceding if/while/try didn't execute.
elseif	condition; commands	do if condition is true but preceding condition was false.
enable	all | command [, command]...	allow/deny CLI commands.
encounters	[param]	list indicated type of data, possibly filtered by param.
entity		give details of your current pastamancer combat entity.
entryway	[clover]	automatically complete quest [using a clover].
equip	[list filter] | [slot] item	show equipment, or equip item [in slot].
events	[clear]	clear or show recent events.
exec*	[numberx] filename | function [parameters]	check/run script.
exit		logout and exit KoLmafia.
[,[-]item]...	[; cmds]	compare prices, do cmds with "it" replaced with best.
factory	report digits	Given a string of 7 dwarven digits, report on factory.
familiar[?]	unlock | species | none	list or change familiar types
field	harvest ]	view or use your mushroom plot
find	item	ensure that you have item, creating or buying it if needed.
flowers		commit random acts of PvP.
fold[?]	item	produce item by using another form, repeated as needed.
forum*		visit the official KoL forums.
friars	booze	get daily blessing.
galaktik(hp|mp)	[amount]	restore some or all hp or mp
gc		force Java garbage collection.
gear		switch to tab or open window
get	preference [ = value ]	show/change preference settings
ghost[?]	[either] item [, item]...	use/consume items
goal*	add condition | set condition	modify your adventuring goals.
gourd		automatically complete quest.
grandpa	query	Ask Grandpa about something.
guardians		automatically complete quest.
guild		automatically complete quest.
hagnk	outfit name | item [, item]...	pull items from Hagnk's storage.
hedge*		automatically complete quest.
help	[filter]	list CLI commands [that match filter].
hermit[?]	[item]	get clover status, or trade for item.
hiddencity	square [temple|altar item]	set Hidden City square [and perform an action there].
hobo[?]	[either] item [, item]...	use/consume items
holiday	HolidayName	enable special processing for unpredicted holidays.
hottub		soak in your clan's hot tub
http:*		visit URL without showing results.
if	condition; commands	do commands once if condition is true (see condref).
insults		list the pirate insult comebacks you know.
inv*	[param]	list indicated type of data, possibly filtered by param.
item		switch to tab or open window
junk		use, pulverize, or autosell your junk items.
kmail	message ]	send kmail
later	commands	adds a button to do commands to the Daily Deeds list.
leaflet	command	complete leaflet quest [without using magic words].
load	[numberx] filename | function [parameters]	check/run script.
locations	[param]	list indicated type of data, possibly filtered by param.
log	[status],[equipment],[effects],[etc.]	record data, "log snapshot" for all common data.
logecho	timestamp | text	include timestamp or text in the session log only.
login	username	logout then log back in as username.
logout		logout and return to login window.
logprint	timestamp | text	include timestamp or text in the session log only.
lookup	item | effect	go to appropriate KoL Wiki page.
mail		switch to tab or open window
make	[ item... ]	list creatables, or create specified items.
mallbuy	item [@ limit] [, another]...	buy from NPC store or the Mall.
mallsell	item [[@] price [[limit] num]] [, another]...	sell in Mall.
weight]	keyword, ...	run the Modifier Maximizer.
maze		automatically complete quest.
mcd	number	set mind control device (or equivalent) to new value.
mind-control	number	set mind control device (or equivalent) to new value.
mix	[ item... ]	list creatables, or create specified items.
modifies	filter	list all possible sources of modifiers matching filter.
modref	[object]	list all modifiers, show values for player [and object].
modtrace	filter	list everything that adds to modifiers matching filter.
moleref		Path of the Mole spoilers.
monsters	location	show combat details for the specified area.
mood*	execute | repeat [numTimes] | moodName [numTimes]	mood management.
moon*	[param]	list indicated type of data, possibly filtered by param.
mpitems		counts MP restoratives in inventory.
namespace	[filter]	list namespace scripts and the functions they define.
nemesis		automatically complete quest.
nuns	[mp]	visit the Nunnery for restoration [but only if MP is restored].
objective*	add condition | set condition	modify your adventuring goals.
olfact*	[item] list | goals ) [abort]	tag next monster [that drops all items in list, or your goals].
opt*		switch to tab or open window
outfit	checkpoint | name	list, save, restore, or change outfits.
overdrink[?]	[either] item [, item]...	use/consume items
pause	[seconds]	pause script execution (default 1 second).
ply	[ item... ]	list creatables, or create specified items.
print	timestamp | text	include timestamp or text in the session log.
priphea		launch KoLmafia GUI.
pull	outfit name | item [, item]...	pull items from Hagnk's storage.
pulverize	item [, item]...	pulverize specified items
putty	[item] list | goals ) [abort]	tag next monster [that drops all items in list, or your goals].
pvp	[ target [, target]... ]	PvP for dignity or flowers
pvplog*		summarize PvP results.
quark[?]	[itemList...]	gain MP by pasting unstable quark with best item from itemList (or your junk list).
quit		logout and exit KoLmafia.
radio		switch to tab or open window
raffle	ticketsToBuy [ inventory | storage ]	buy raffle tickets
recover*	mp | mana | both	attempt to regain some HP or MP.
refresh	equip | inv | storage | familiar | stickers	resynchronize with KoL.
relay		open the relay browser.
remedy[?]	effect [, effect]...	remove effects using appropriate means.
remove	slot | name	remove equipment in slot, or that matches name
repeat	[number]	repeat previous line [number times].
reprice		price all max-priced items at or below current Mall minimum price.
restaurant[?]	[ daily special | item ]	show daily special [or consume it or other restaurant item].
restore*	mp | mana | both	attempt to regain some HP or MP.
retrieve	item	ensure that you have item, creating or buying it if needed.
run	[numberx] filename | function [parameters]	check/run script.
safe	location	show summary data for the specified area.
save	as mood	add your current effects to the mood.
searchmall	item [ with limit number ]	search the Mall.
sell	item [, item]...	autosell items.
send	message ]	send kmail
session	[param]	list indicated type of data, possibly filtered by param.
set	preference [ = value ]	show/change preference settings
shrug[?]	effect [, effect]...	remove effects using appropriate means.
skill[?]	[ [count] skill [on player] ]	list spells, or use one.
skills	[param]	list indicated type of data, possibly filtered by param.
sleep	number	rest on your clan sofa for number turns.
slimeling[?]	[either] item [, item]...	use/consume items
smash	item [, item]...	pulverize specified items
smith	[ item... ]	list creatables, or create specified items.
soak		soak in your clan's hot tub
sofa	number	rest on your clan sofa for number turns.
spade	[prices URL]	submit automatically gathered data.
speculate	unequip slot | familiar type | up eff | uneffect eff | quiet ; [another;...]	predict modifiers.
squeeze[?]	item	produce item by using another form, repeated as needed.
start	[numberx] filename | function [parameters]	check/run script.
stash	[put] item... | take item...	exchange items with clan stash
status	[param]	list indicated type of data, possibly filtered by param.
sticker*	sticker1 [, sticker2 [, sticker3]]	replace worn stickers.
storage	[param]	list indicated type of data, possibly filtered by param.
styx	moxie	get daily Styx Pixie buff.
summary	[param]	list indicated type of data, possibly filtered by param.
summon	location | number	use the Summoning Chamber.
tavern		automatically complete quest.
telescope	[look] high | low	get daily buff, or Lair hints from your telescope.
text	URL	show text results from visiting URL.
tinker	[ item... ]	list creatables, or create specified items.
tower		automatically complete quest.
train	turns number	train familiar.
trigger*	[type,] effect [, action]	edit current mood
try	; commands	do commands, and continue even if an error occurs.
unalias	word	remove a CLI abbreviation.
undercut		price all max-priced items at or below current Mall minimum price.
uneffect[?]	effect [, effect]...	remove effects using appropriate means.
unequip	slot | name	remove equipment in slot, or that matches name
untinker	[ item... ]	complete quest, or untinker items.
up?	effect [, effect]...	extend duration of effects.
update	prices URL or filename	download most recent data files, or revert to built-in data.
use[?]	[either] item [, item]...	use/consume items
using	filename	add ASH script to namespace.
validate	[numberx] filename | function [parameters]	check/run script.
verify	[numberx] filename | function [parameters]	check/run script.
version		display KoLmafia version.
wait	[seconds]	pause script execution (default 1 second).
wear	[list filter] | [slot] item	show equipment, or equip item [in slot].
whatif	unequip slot | familiar type | up eff | uneffect eff | quiet ; [another;...]	predict modifiers.
while	condition; commands	do commands repeatedly while condition is true.
wield	[list filter] | [slot] item	show equipment, or equip item [in slot].
wiki	searchText	perform search on KoL Wiki.
win	game	I'm as surprised as you! I didn't think it was possible.
zap	item [, item]...	transform items with your wand.