Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If Bash says a command is not found, first check how Bash resolves its name with type -a tool and type -P tool. Then check whether the executable exists and whether its directory is in $PATH. If the file exists, run it by pathname or add its trusted directory to PATH; if it does not, find and install the distribution package that provides it. If the command was recently moved, check Bash’s remembered location with hash -t tool and clear stale entries with hash -r.

What “command not found” can mean

In Bash, command lookup depends on what kind of name you entered. Bash checks for a function and a builtin before searching PATH for an executable when the command name contains no slash. Bash can also remember executable locations. If lookup fails and no command_not_found_handle function is defined, Bash reports an error and returns status 127. Distributions or shell configuration may customize the error, so the displayed message can vary. See the GNU Bash manual’s Command Search and Execution.

A name containing a slash, such as ./tool or /opt/tool/bin/tool, is treated as a pathname instead of being searched through PATH. This distinction helps separate a lookup problem from a missing file or an execution problem.

Check what Bash resolves before changing anything

Run these commands in the shell where the problem occurs, replacing tool with the command name:

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Sale
Nicpro Mechanical Carpenter Pencils for Construction (Black, Red) With Case| Deep Hole Marker Pencil Set Includes Sharpener and 26 Refills, Comfortable Grip, Heavy Duty Woodworking Tools for Architect
  • Valued Carpenter Pencil Set: You will get 2 pcs solid carpenter pencils with 26 piece 2.8 mm refills, 1 replaceable sharpener, 1 plastic storage box.The complete carpenter pencils combination allows you to finish your work faster and more easily
  • Deep Hole Marker Pencil: The deep-hole construction pencils adopts 45mm elongated tip design, which is more convenient to mark in the small hole or in other tight areas that other carpenter markers cannot reach
  • Carpenter Pencils with Sharpener: The sharpener is screwed into the top of the work pencil, which won't get lost either. Built-in pencil sharpener that keep the lead with pointed and smooth to Improves line of sight in fine work
  • Stronger Solid Lead: This work pencil is matched with a 2.8 mm thick lead , which is much thicker and stronger during the drawing process of construction work, it will not break or damage easily
  • Marks on Various Surfaces: 3 colors solid construction pencil can marks on various surfaces,such as metal, plastic, wood, paper etc. Ideals for woodworkers, contractors, craftsmen, builders, merchants and masons
printf '%sn' "$SHELL"
type -a tool
type -P tool

type -a shows applicable interpretations and matches, including aliases, keywords, functions, builtins, and files. type -P forces a search for executable files in PATH. The options and behavior are documented in the GNU Bash manual’s Bash Builtins.

$SHELL often names your login shell, not necessarily the shell currently interpreting the command. If it matters which shell is running, do not treat that variable alone as proof. This procedure describes Bash; other shells may have different lookup commands and behavior.

Rank #2
Sale
DEWALT 20V MAX Cordless Drill and Impact Driver, Power Tool Combo Kit , Includes 2 Batteries, Charger and Bag (DCK240C2)
  • Ergonomically Designed: Work in tight areas with a compact design that gets into tough spots
  • Compact and Lightweight: Both tools are designed to fit into difficult to reach spaces. The 1/4" impact driver has a length of 5.55 in. and weighs just 2.8 lbs, while the 1/2" drill/driver measures only 7.5 in. and weighs 3.6 lbs
  • Both the DEWALT impact driver and electric drill driver feature integrated LED work lights with a convenient 20-second delay, ensuring enhanced visibility in dimly lit or challenging work areas
  • One-Handed Loading - Keep one hand free with a 1/4 in. hex chuck that accepts 1 in. bit tips
  • Power drill cordless with 1/2" single sleeve ratcheting chuck provides tight bit gripping strength, making bit changes faster and more secure

Inspect PATH and test the executable

Print the PATH received by the current shell:

printf '%sn' "$PATH"

PATH is a colon-separated list of directories Bash searches for command names. Check whether the expected executable name is present in those directories. Avoid replacing PATH wholesale: that can remove access to standard system commands. An empty PATH element can have current-directory implications, so do not add one casually.

If you know a likely installation location, check the exact file and its permissions, then try its pathname:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
Push to Unlock,Katerk 6pcs 1/4 inch Hex Shank Aluminum Alloy Screwdriver Bit Holder Light-Weight Quick-Change Extension Bar Keychain Drill Screw Adapter Portable,Black Carabiner,Tool Gifts for Men
  • 【Great Compatibility】This Katerk 1/4 inch hex shank bit holder is specifically designed for 1/4 inch hex shank drill bits. It's compatible with most 1/4 fast hex handles, hex sockets, various electric screwdrivers, and handheld screwdrivers. The bit holder makes it a valuable addition for any handyman.
  • 【Secure and Safe】Built with a secure backup nut design, each drill bit holder securely locks onto your bits, ensuring they stay firmly in place. Additionally, our bit holder incorporates a high-quality steel ball rolling design that holds up to several kilograms of weight, ensuring your various drill bits don't fall off.
  • 【Easy One-Handed Operation】The bit holder for impact driver allows you to change bits single-handedly, simplifying your workflow. Its multi-color design further allows for quick identification of the drill bit you need.
  • 【Compact and Convenient】Thanks to its compact size, this 1/4 inch bit holder is easy to carry around. The bit holder allows for easy attachment to various tools, making this a convenient addition to your construction accessories. The Katerk bit holder is cast from high-quality alloy material, promising a long product lifespan. Despite its rugged strength, the bit holder remains lightweight, making it portable.
  • 【Cool Christmas Gift For Men Stocking Stuffers】 This screwdriver bit holder, driver bit holder, impact bit holder, can be given as a gift to your loved one, especially for anyone involved in construction or electrical work. It's a must-have for stocking stuffers for men and women, tools gifts for dad, tech gadgets for men, gifts for dad, gifts for him, gifts for husband, gifts for boyfriend, cool gadgets for men, and cool gifts for dad.
ls -l /likely/directory/tool
/likely/directory/tool --version

If running the pathname works but typing tool does not, the issue is likely PATH or command resolution. If the pathname fails too, read the error before changing PATH: permissions, a missing file, or an invalid executable or interpreter can also prevent execution.

Choose the fix that matches what you found

What you found Appropriate next step
The executable exists in a trusted directory outside PATH Run it by full pathname, or add that directory to PATH for the shell that needs it.
No executable is present where expected Identify the Linux distribution package that provides the command, then install it using the system’s normal package manager and administrator policy.
The command used to work, but was moved, upgraded, or removed while this shell remained open Inspect Bash’s remembered location and clear its command hash if it is stale.

Do not assume the package has the same name as the command. Package names and installation steps vary by distribution; consult that distribution’s official package search or package documentation rather than guessing.

Rank #4
2 Pack Carpenter Pencils Mechanical Pencils with 12 Refills, (2 Colors)
  • Long Nib and Deep Hole Marker: Our mechanical carpenter pencil with 45mm nib is designed for easy marking of deep holes or narrow areas. These construction pencils are the great choice for woodworking tools, construction tools, carpenter tools, contractor tools, wood carpentry tools and architect tools
  • Extra Refills in 2 Colors for Versatile Marking: The construction mechanical pencil comes with 12 extra 2.8mm refills, including 6 red and 6 black refills. The black refill is suitable for light surfaces, while the red wax is perfect for dark surfaces. Our carpenter mechanical pencil makes sure that you'll have an ample supply for extended use
  • Built-in Sharpener: Our construction pencil comes with a built-in sharpener to ensure the mechanical pencil tip is always sharp and ready for use. Never buy an extra pencil sharpener again. A great tool for any woodworker pencil, contractor pencils. The refill can easily be extended or retracted with a simple click of the pencils mechanical, allowing you to work more efficiently and accurately
  • Portable Clip Design: Our deep hole construction pencil features a portable clip design, easy to carry and attach to your pocket or tool box, so that you can keep the carpenter pencils mechanical close at hand, making it a convenient tool to have on the go. Great gifts choice for carpenters
  • Stronger Pencil Lead: The black refills are made of lead, sturdy and smooth. The red refills are made of wax, clear and light. These marking pencils are much thicker and stronger than normal pencils during the marking process of construction work, suitable for various surfaces, such as glasses, metal, boards, floors, walls, furniture, etc. The written marks can be easily wiped with a wet paper towel when needed

Run an existing tool by pathname

For a one-time use, invoke the known executable directly, for example /opt/tool/bin/tool --version. Because the command includes slashes, Bash executes it as a pathname rather than searching PATH. See Bash command search and execution.

Temporarily add a trusted directory to PATH

For a test in the current shell, prepend the known directory while preserving the existing PATH:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Best Value
Milwaukee 48-22-3104 Inkzall Point Marker, Fine, Black, 4-Pack
  • Milwaukee Ink all Fine Point Marker, Black, 4 Per Pack
  • 4 per pack Features Clog Resistant Marker Tip Writes through Dusty, Wet and Oily Surfaces Durable Marker Tip for Writing on Concrete, OSB and Rough Surfaces
  • Clog resistant tip writes on dusty, wet and oily surfaces and is optimized for rough surfaces such as OSB, cinderblock and concrete
  • Hard hat clip- attaches for easy access
  • Quick dry time with reduced smearing and marking
PATH="/known/tool-directory:$PATH"
export PATH

Then test type -P tool and run the command. Add only a directory you trust: PATH controls which executable can run when you enter a matching command name.

Make a PATH change persistent only in the right startup context

For a lasting change, put the assignment in the startup file read by the shell and session that need it. There is no single startup file that applies to every Linux setup: the right file depends on the shell, whether it is interactive or a login shell, and how it was started. Check the relevant shell’s documentation and session configuration before editing a file. Reopen the relevant shell or session and verify PATH and command resolution afterward.

Install the package if the executable is absent

Identify your distribution, search its official package documentation for the package providing the executable, and install through the normal package manager according to local administrator policy. Because exact package names and install commands differ by distribution, do not infer a package name from the command name.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Clear a stale Bash command location

Bash can save full filenames in a hash table to avoid repeatedly searching PATH. If a tool was moved or removed during the current shell session, inspect the saved pathname and clear remembered locations:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
hash -t tool
hash -r

hash -t tool prints the remembered pathname when one is stored; hash -r forgets remembered command locations. Assigning a new PATH also clears Bash’s hashed filenames. See the GNU Bash manual’s Bourne Shell Builtins. A hash-table path may not be the first matching executable in the current PATH order, so use type -a tool to inspect matches as well.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.